All buy-side activities, such as creating and managing campaigns, are handled through advertisers. Before creating a campaign, you must have an advertiser linked to your account. Each API user account can support multiple advertisers, giving you the flexibility to structure them according to your business needs.
To help you manage advertisers, there are three different APIs available, each with a specific purpose:
-
Advertisers Management API: Create and edit advertisers.
-
Advertisers Addresses API: View and update the address details for an advertiser.
-
Advertisers Classifiers API: View assigned manager or co-manager, selected industry vertical, time zone, and tracking domains.
Use advertisers' APIs to:
-
Create a separate advertiser for each client, if you're an agency with multiple clients.
-
Set up an advertiser for each brand, if you're an enterprise with multiple brands.
-
Create an advertiser for each market or region, if you're a global enterprise.
To start working with advertisers' APIs, you must:
-
Have an Adform DSP or Ad Server account.
-
Have an API-specific user account within your business account.
-
Have the Manage Advertisers permission assigned to the API user account.
-
Get your OAuth credentials.
-
Authenticate with advertisers' APIs using Postman.
To work with advertisers APIs, Adform must assign the following scopes to your OAuth client:
-
https://api.adform.com/scope/buyer.advertisers: Yields access to all endpoints of the Advertisers Management API.
-
https://api.adform.com/scope/buyer.advertisers.readonly: Yields read-only access to some of the endpoints of the Advertiser Management API.
-
https://api.adform.com/scope/buyer.classifiers.readonly: Yields read-only access to all endpoints of the Advertisers Classifiers API.
-
https://api.adform.com/scope/ndw.addresses: Yields full access to all endpoints of the Advertisers Addresses API.
-
https://api.adform.com/scope/ndw.addresses.readonly: Yields read-only access to some of the endpoints of the Advertisers Addresses API.
To get the required access, contact Adform Support (technical@adform.com) with your OAuth client and the needed scope.
Tip
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.