To authenticate your OAuth client with Adform APIs, you need Client ID and Client Secret credentials. To receive your credentials, follow the procedure in Get Authentication Credentials for Adform APIs.
To start working with Adform APIs, you must select and set up an API platform to use. You can work with any platform of your choice. To help you get started, Adform provides API guidance using Postman.
Follow these steps to configure Postman to work with Adform APIs:
-
Download and install the Postman desktop app.
-
Double-click the Postman icon to open the Postman desktop app.
-
Click to open a new tab.
-
In the dropdown menu, select GET method.
-
In the request URL field, enter a full GET endpoint URL from an API you want to use, for example, https://api.adform.com/v1/seller/deals.
-
Click the Authorization tab.
-
In the Type dropdown menu, select OAuth 2.0.
-
In the Configure New Token section, enter the required fields:
-
Token Name: The name you want to use for your token.
-
Grant type: In the dropdown menu, select Client Credentials.
-
Access Token URL: https://id.adform.com/sts/connect/token.
-
Client ID: Your username based on your access credentials.
-
Client Secret: Your password based on your access credentials.
-
Scope: Scope is the access needed for the API you want to use. Each access URL must be space-delimited. For example: https://api.adform.com/scope/api.placements.read https://api.adform.com/scope/seller.deals.
-
Client Authentication: In the dropdown menu, select Send as Basic Auth header.
-
Refresh Token URL: https://id.adform.com/sts/connect/authorize.
The result should look like this:
-
-
Click Get New Access Token to generate a new token.
Note
Postman saves the configuration information together with the access token to use in later API calls.
-
To use the token with your request, select Use Token and click Send.
Note
If there is an issue retrieving a new access token or you see an “Authentication Failed” message, check if you have the necessary permissions for all the listed access URLs and if there are no syntax errors in the access URLs list.
Postman configuration is successful if your API call returns the information you requested with the selected API endpoint. Following this example, you would receive a list of deal IDs that you have within your SSP account.