Cofinity-X

Create a Technical User and assign the 'Offer Management' role. Once this step is completed, you'll receive a Client ID and Client Secret which are essential for the next steps.

Use the following endpoint for your POST request:

<code>https://portal-backend.beta.cofinity-x.com/api/administration/connectors</code>

<code>https://portal-backend.services.cofinity-x.com/api/administration/Connectors</code>

Go to the Authorization tab in Postman and fill in the following details:

Access Token URL (Pre-Prod): <a href="https://centralidp.beta.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token" target="_blank" rel="nofollow noopener noreferrer"><code>https://centralidp.beta.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token</code></a>

Access Token URL (PROD): <code>https://centralidp.services.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token</code>

Client ID: Enter the Client ID from the technical user you created.

Client Secret: Enter the Client Secret from the technical user.

Click on ‘Get New Access Token’, and then click 'Use Token' to apply it to your session. 

1. Auth Type: OAuth 2.0
2. Grant Type: Client Credentials
3. Access Token URL (Pre-Prod): <a href="https://centralidp.beta.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token" target="_blank" rel="nofollow noopener noreferrer"><code>https://centralidp.beta.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token</code></a>
4. Access Token URL (PROD): <code>https://centralidp.services.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token</code>
5. Client ID: Enter the Client ID from the technical user you created.
6. Client Secret: Enter the Client Secret from the technical user.
7. Click on ‘Get New Access Token’, and then click 'Use Token' to apply it to your session.

Step 4: Configure the Request Body

Switch to the Body tab, select 'Form-data', and enter the following:

Key: <code>Name</code> - Value: [Choose a name to display for your EDC on the portal]

Key: <code>ConnectorURL</code> - Value: [Your EDC endpoint, e.g., <code>https://testxxx-edc.enablement.preprod.cofinity-x.com</code>]

Key: <code>Location</code> - Value: DE

Key: <code>TechnicalUserID</code> - This is optional unless you want to specify the technical user ID you created.

1. Key: <code>Name</code> - Value: [Choose a name to display for your EDC on the portal]
2. Key: <code>ConnectorURL</code> - Value: [Your EDC endpoint, e.g., <code>https://testxxx-edc.enablement.preprod.cofinity-x.com</code>]
3. Key: <code>Location</code> - Value: DE
4. Key: <code>TechnicalUserID</code> - This is optional unless you want to specify the technical user ID you created.

<code>401 Unauthorized</code>: Indicates your token might be invalid or wrong. Ensure you have used the correct role (offer management) for the technical User ID created.

<code>403 Bad Request</code>: Indicates there’s something wrong in the request you made. More likely to occur if you do not use ‘Form-data’ in the Body tab and you make use of ‘raw’ to input your data. It could also occur if the content type field is not set right in your headers tab.

<code>403 Forbidden</code>: The request is a legal request but the server is refusing to respond to it. Indicates the <code>client ID</code> and <code>Client Secret</code> do not have the correct role.

<code>500 Internal Server Error</code>: Cannot determine exactly what is causing the error. Remove the <code>technicalUserID</code> key in your request.

Reach out to customer support for further assistance: <a href="mailto:support@cofinity-x.com" target="_blank" rel="nofollow noopener noreferrer">support@cofinity-x.com</a>.

1. <code>401 Unauthorized</code>: Indicates your token might be invalid or wrong. Ensure you have used the correct role (offer management) for the technical User ID created.
2. <code>403 Bad Request</code>: Indicates there’s something wrong in the request you made. More likely to occur if you do not use ‘Form-data’ in the Body tab and you make use of ‘raw’ to input your data. It could also occur if the content type field is not set right in your headers tab.
3. <code>403 Forbidden</code>: The request is a legal request but the server is refusing to respond to it. Indicates the <code>client ID</code> and <code>Client Secret</code> do not have the correct role.
4. <code>500 Internal Server Error</code>: Cannot determine exactly what is causing the error. Remove the <code>technicalUserID</code> key in your request.
5. Reach out to customer support for further assistance: <a href="mailto:support@cofinity-x.com" target="_blank" rel="nofollow noopener noreferrer">support@cofinity-x.com</a>.

Step 1: Log into Portal

Step 2: Prepare Your POST Request

Step 3: Set Up Authorization

Step 4: Configure the Request Body

POSSIBLE ERRORS & SOLUTIONS