GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In

Onboarding Checklist

This checklist will take you through the process to get started with the Criteo API. The steps are divided into several categories, some of which you might decide to skip if they aren't applicable to your needs. To get the most from this document, read and execute steps in order.

The list contains three types of items:

  • βœ” To-do: Steps that are required in order to perform a certain task or set up a certain part of your app
  • πŸ’‘ Info: Information that is not critical for the process, but will help you understand the context or clarify certain steps.
  • 🚨Warning: Things to be aware of throughout the process, as they might involve additional implementation effort or incur certain risks

Getting familiar with Criteo API and products

  • βœ” Learn more about Criteo API use cases: If you already know Criteo, read our Is the Criteo API for you? article. Get some inspiration from our use cases if you are not sure to use the Criteo API
  • πŸ’‘ Learn more about Criteo: If you are new to Criteo, read our Criteo Marketing Solutions for API users (if you are an Advertiser or an Agency) or our Criteo Publishers for API users [Coming soon] (if you are an inventory provider) to learn more about Criteo API capabilities

Getting started with access

Create a Criteo developer account

  • βœ” Start by creating your Criteo account (if you already have an account please skip this step): Go to our landing page at and click on Get Started
  • βœ” Complete our registration form to create a Criteo developer account: You will receive a confirmation email to finish the process

Create your organization once you have created your developer Criteo account

  • βœ” Complete the organization details form
  • βœ” Once created you will have access to the developer portal

Modifying an Account or Organization

Learning how to use Criteo endpoints

Create an app

  • βœ” Once you have created your organization, you will have access to the MyApps page. This page will give you a summary of the apps you have created
  • βœ” To start creating an app, click on the Start building button. Define an app name, description, and image to create your app
  • βœ” These fields will be editable before publishing an app (for more details see the Managing my app section)

App name, image, and description

  • πŸ’‘ These elements will be visible to the Advertisers, Brands, or Publishers you share your app with. Make sure to provide some content describing your business and inspiring confidence to your app users

Get your app credentials

  • βœ” Get your API credentials once your app is created. Start by creating a set of credentials by clicking on generate and download a new key. This will create a new set of credentials (API Key and API Secret)
  • βœ” The API Key will be available in the credentials table and the API Secret will only be provided once (a file with the secret will automatically download when creating a set of credentials), please save it somewhere carefully! For more details about credentials, see the Create your app section

Managing my credentials

  • πŸ’‘ You will be limited to five API credentials for an app (for ex. one for production, one for troubleshooting, and three others for any other use cases you can imagine)
  • πŸ’‘ For more details about how to edit and delete credentials, see the Create your app

The API Secret shared only once

  • 🚨 The API Secret will be available in the file automatically downloaded when creating a set of credentials. Please keep it safe as it will be the only time we will be able to share it with you!

Define your app scope

Select the services you would like to access through your app (Marketing Solutions, Retail Media, or Publisher)

  • βœ” Once you have chosen a Service, click save. This action cannot be undone

Saving the Service cannot be undone

  • 🚨 Once you click on save, you won't be able to switch between Marketing Solutions, Retail Media, or Publishers any longer. So please choose carefully (In case you made a mistake, don't worry! You can just create a new app πŸ˜‰)

Then select the authorizations you would need for your app

  • βœ” Click on the Save button to save your authorization selection
  • βœ” You can update the authorizations as many times as you want before validating your app through the Generate consent link button

Validate your app and generate a consent URL

Click on Generate & Copy URL to finish your app

  • βœ” This will generate a consent link you can share with an advertiser/brand/publisher to obtain authorization to access their assets
  • βœ” Changing the name, description, image, or app scope will no longer be available after the first URL creation
  • βœ” You can generate as many URLs as you want and each URL can only be used once

Validating an app sets the app information and scope

  • 🚨 Changing the name, description, image, or app scope will no longer be available after the first URL creation

More information about how authorization works

Start using your API connection

Once you click Generate & Copy URL, the consent URL will be directly copied into your clipboard

  • βœ” Share your URL by email, Slack, or any other means to your advertiser, brand, or publisher.
  • βœ” Once they click the link, they will be redirected to the Criteo Consent Portal where they can provide you with the requested authorization levels for the accounts in their portfolio

Start using the Criteo API endpoints

  • βœ” Call the portfolio endpoint with your credentials to confirm you have now access to the accounts.
  • βœ” You will then be able to use the domains in your scope for those advertisers/brands/publishers and start using Criteo APIs! πŸŽ‰

What’s Next