GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In
Guides
These docs are for v2022.07. Click to read the latest docs for v2024.10.

Authentication

  • To get started with our APIs, use the endpoint below to generate an Access Token with your API credentials

  • The Access Token is a Bearer token to be included in the Authorization Header of all Campaign or Analytics API requests

  • Multiple tokens may be generated, each valid for 15 minutes or 900 seconds

Endpoint

https://api.criteo.com/oauth2/token

📘

Note

Generate another access token when it expires, signaled by a 401 Unauthorized HTTP status code

Parameters

ParameterDescription
client_id stringSetup your API credentials through our Developer Portal, learn more here
client_secret stringSetup your API credentials through our Developer Portal, learn more here
grant_type stringMust be client_credentials

Generate an Access Token

  • This endpoint generates a new access token using your API credentials
https://api.criteo.com/oauth2/token

Sample Request

curl -X POST "https://api.criteo.com/oauth2/token" \
    -d 'client_id={client_id}' \
    -d 'client_secret={client_secret}' \
    -d 'grant_type=client_credentials'

Sample Response

{
    "access_token": "<TOKEN STRING>",
    "token_type": "Bearer",
    "expires_in": 900
}