GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In
Guides

Create Your API Application

Suggest Edits

Create your API application

Once you have created your organization, you can access the My Apps page to begin creating your application. This page is also where you will manage your Criteo API applications.

To start creating your API application, click the Create a New App button in the top right corner of the page. This will initiate the application creation process.

Step 1 - Create application

App details

  • Provide a name for your application, along with an optional description and app image. Please ensure that your application has a clear and identifiable name, as this greatly assists our teams in providing faster and more effective support during troubleshooting.

❗️

API applications cannot be deleted. Once this step is completed, your application will appear in the "My Apps" dashboard.

Authentication method

  • Criteo’s API supports two OAuth authentication methods: Client Credentials and Authorization Code. Each method has its own advantages, so before proceeding, we strongly recommend reviewing which authentication method is best suited to your application’s needs.

📘

Trying to decide which OAuth method is right for you?

If you're unsure which authentication method to use, take a look at our OAuth App Implementation guide for an overview of each authentication method.

Step 2 - App activation

Once you've selected the appropriate authentication method, proceed to choose the service you’ll be using.

Services

  • Choose the Criteo service your API application will interact with:
    • C-Growth and Marketing Solutions
    • C-Max and Retail Media

Step 3 - Authorizations

Domains

  1. Choose the domains that define the permission levels your application will need. These domains determine which endpoints your application can access.

  2. After selecting the appropriate domains, click Activate App.

⚠️

Once activated, you won’t be able to change the name, description, image, or app scope.

Retail Media Domains

DomainDescriptionAuthorization Types
AccountsManages permissions to endpoints responsible for describing accounts' entities, with their properties and relationships, like parent/child accountsNo access / Read / Manage
AnalyticsManages permissions to generate reporting data for campaigns & line-items, considering desired list of dimensions & metricsNo access / Read
AudiencesManages permissions to check/manage audiences available to campaignsNo access / Read / Manage
BalancesManages permissions to endpoints responsible for configuring and retrieving balance entities, which define spending limits applied across campaigns linked to an account.No access / Read / Manage
CampaignsManages permissions to endpoints responsible for campaigns management, including line-items, balances and creativesNo access / Read / Manage
CatalogManages permissions to check/manage products catalogsNo access / Read / Manage

📘

The Account manage and Balance manage permissions must be first requested to be activated by your Criteo contact to appear as options when creating your apps. Note that they cannot be added to existing applications.

Once you activate your application, you will be redirected to your application details page to complete the final steps of your application configuration.

Updated 6 days ago

What’s Next