> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OAuth App - Client Credentials Setup

This guide provides step-by-step instructions on setting up an API application using the client credentials workflow

# Setting up an client credentials application

## Client Credential

Log in to the Criteo Partners Portal and create a new app by clicking the ➕ button in the `My apps` section.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/ff276e4-image.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=d5a5497e5888dadd617cac9d620002e8" alt="" width="1852" height="725" data-path="images/retail-media/v2025.01/docs/ff276e4-image.png" />
</Frame>

This opens a modal where you can choose the type of application.

***

### Step 1. Create app

#### App details

1. Provide your app name and description. Please make sure to use a clearly identifiable name for your app, as it can be of great help with troubleshooting later on. Optionally, add an image to identify your application. On your app page, you can define the scope of your application and the OAuth parameters. For more details on defining your app scope, visit this [page](/retail-media/v2026-preview/docs/onboarding-checklist#3-define-your-app-scope). Upon clicking `Create new key`, the `client ID` and `client secret` will be generated and made available as a downloadable .txt file.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/ec2ea86-portal-_clientcreds1.gif?s=43ce6d4970b88cb843e7c4722eee8029" alt="" width="1896" height="725" data-path="images/retail-media/v2025.01/docs/ec2ea86-portal-_clientcreds1.gif" />
</Frame>

***

#### Authentication method

1. Select your app's authentication method. Choose between Client Credentials or Authorization Code. For this setup, we are selecting client credentials, but you can review our [OAuth App implementation](/retail-media/v2025.01/docs/oauth-app-implementation) guide to determine the best option for your organization.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/74936ae-client_credentials_option.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=722fb5ab09922ab9b56df23680a689cc" alt="" width="1737" height="697" data-path="images/retail-media/v2025.01/docs/74936ae-client_credentials_option.png" />
</Frame>

***

### Step 2. App activation

#### Service

Choose the Criteo service your API application will use. Select C-Growth for marketing solutions or C-Max for retail media.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/4a14336-services.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=53e0f05c472e533579ac05ed891eb13c" alt="" width="1847" height="501" data-path="images/retail-media/v2025.01/docs/4a14336-services.png" />
</Frame>

***

### Step 3. Authorizations

#### Domains

Choose the domains to specify which permissions your application requires.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/fb84380-portal-_step4final_1.gif?s=c00fe8c3ff4494a987a84afe23f6645d" alt="" width="1896" height="750" data-path="images/retail-media/v2025.01/docs/fb84380-portal-_step4final_1.gif" />
</Frame>

<Warning>
  After this step, you can no longer change the name, description, image, or app scope.
</Warning>

***

## App Credentials

### Create new key

To generate your `client_id` and `client_secret`, click the `Create new key` button. This will trigger a download of a text file containing your API keys. Make sure to store the keys securely for future access.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/544d9f0-image.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=f8498ec99899bcd901c6bfabab1372ac" alt="" width="1824" height="465" data-path="images/retail-media/v2025.01/docs/544d9f0-image.png" />
</Frame>

***

## Consent URL

### Generate new URL

Once your API application is set up, you must request consent from the advertiser or publisher to access their assets. You can generate multiple URLs, but **each URL can only be used once**.

<Frame>
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/b205ae3-consenturl.gif?s=522c8634f04953f338df5c1e9006eeb6" alt="" width="1896" height="725" data-path="images/retail-media/v2025.01/docs/b205ae3-consenturl.gif" />
</Frame>

* Click on `Generate new URL`. This will generate a fresh new consent URL every time this step is done.
* Click the `Copy` icon to the right of the consent URL field.
* Share this URL with a user who has access to the advertiser or publisher account. Users with **admin, business manager, or technical manager** roles can grant consent to API applications in retail media.

***

**What’s Next**

* [OAuth App - Authorization Code Setup](/retail-media/v2025.01/docs/oauth-app-authorization-code)
* [Developer Accounts](/retail-media/v2025.01/docs/developer-accounts-organizations-apps)