> ## 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.

# Use Postman with the Criteo Retail Media API

## Introduction

Use the Criteo API Postman collection to quickly get started with Criteo API.

This guide will help you to make your first request to Criteo API using Postman.

***

## Pre-requisites

To be able to use Criteo's Postman collections, please make sure you have:

* Completed the application [onboarding checklist](/retail-media/v2026-preview/docs/onboarding-checklist),
* Installed and set up the [Postman](https://www.postman.com/downloads/) client, as well as made sure your workspace visibility is set to the right settings (`private`, `public`, or`team`) based on the intended audience.

***

## Fork the Criteo API collection

In this step, you set up the environment variables used to retrieve an access token.

Go to [Criteo Postman workspace](https://www.postman.com/realcriteo/workspace/criteo/overview) and click on the collection you would like to test. You will see the collection description on the right-hand side and the list configuration options on the left-hand side.

Click `Create fork` and provide the fork label in the newly opened window, as shown on the following screenshots:

<Frame caption="Create a fork from your chosen Postman collection">
  <img src="https://mintcdn.com/criteo-e1682996/JUXl4tN6qP1utg1F/images/retail-media/v2025.01/docs/0c62e5b-Fork_collection.png?fit=max&auto=format&n=JUXl4tN6qP1utg1F&q=85&s=6047ed8acdd2841c5e16f6f8e9584033" width="2770" height="1338" data-path="images/retail-media/v2025.01/docs/0c62e5b-Fork_collection.png" />
</Frame>

<Frame caption="Add a label and a location to your local collection">
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/c74bc7d-Capture_decran_2022-01-20_a_17.48.44.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=4f548b6f84406b80cc76ff363729a2d8" width="1998" height="1304" data-path="images/retail-media/v2025.01/docs/c74bc7d-Capture_decran_2022-01-20_a_17.48.44.png" />
</Frame>

After completing this step, you should have a local version of the Criteo API collection in your workspace.

***

## Configure authentication

Go to the Criteo API [templated environment](https://www.postman.com/realcriteo/workspace/criteo/environment/12547236-5c1c73f6-1e41-4eec-9ae9-fab7f9ac6bf1). You will see collection of variables that you should customize according to your application credentials.

<Frame caption="Collection of variables to be customized">
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/4d1b8d8-fork_env.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=c5d48ec1c8398737f601e7e38e5db04a" width="2750" height="1254" data-path="images/retail-media/v2025.01/docs/4d1b8d8-fork_env.png" />
</Frame>

Click `Fork` and add a local label to differentiate the environment in your workspace. Once forked, set up the fields as follows:

* In `client_id` and `client_secret` fields, set the **CURRENT VALUE** column to the application `client_id` and `client_secret` values you received from the onboarding step,
* You don't need to change the remaining rows as long as the application grant type is`client_credentials`. If you have a different application type, please get in touch with our support.

These credentials input in the environment are used for authentication in the pre-request scripts. The pre-request script is a script attached to all Criteo API collections, to automatically fetch and supply an access token to protected endpoints.

Finally, on the top right, verify that `MyCriteoConnector` Environment is selected in the dropdown as shown in the screenshot:

<Frame caption="Ensure the environment is &#x22;MyCriteoConnector&#x22; in Postman">
  <img src="https://mintcdn.com/criteo-e1682996/eCLtzx2Ch8FlxnxE/images/retail-media/v2025.01/docs/ea55a20-nonoenv.png?fit=max&auto=format&n=eCLtzx2Ch8FlxnxE&q=85&s=dbb17f6776f2ae9581ac037c2953c232" width="2006" height="1308" data-path="images/retail-media/v2025.01/docs/ea55a20-nonoenv.png" />
</Frame>

***

## Your first API request

Inside the versioned folder, you will find the requests for the various Criteo API endpoints you can call.

To make your first call:

* Expand the folder and then expand into the Advertiser folder,
* Click `Api Portfolio Get` to open the portfolio request,
* On the top right, select `Send`.

<Frame caption="Make your first call from the versioned folder">
  <img src="https://mintcdn.com/criteo-e1682996/JUXl4tN6qP1utg1F/images/retail-media/v2025.01/docs/26255ef-Capture_decran_2022-01-20_a_19.43.18.png?fit=max&auto=format&n=JUXl4tN6qP1utg1F&q=85&s=238e94c4ed51753a4c78b9c200c2cd43" width="2578" height="1198" data-path="images/retail-media/v2025.01/docs/26255ef-Capture_decran_2022-01-20_a_19.43.18.png" />
</Frame>

You will receive a list of accounts consented to your application in the response.

<Check>
  You have now successfully made a Criteo API call using a client credentials authentication. You can follow these steps to make other requests to Criteo API.
</Check>

As a reminder, each of the domains (Audience/Campaign/Analytics, etc.) requires a separate permission which is bound to your application at creation time. If your application does not include `Read` or `Manage` permission on a particular domain, you will get a permission error in response to performing a `GET/PATCH` operation on that domain.

Learn more about application scopes and permissions in [Onboarding Checklist](/retail-media/v2026-preview/docs/onboarding-checklist#3-define-your-app-scope)

More information about error handling can be found in [API Response](/retail-media/v2025.01/docs/api-response).

***

## Contributing to Criteo API

Feel free to make your changes to the forked collection, and then hover over the collection top node and select `Create pull request`. The Criteo API team will review the change and merge the change wherever it makes sense.

***

## Questions

If you keep getting a `code authorization-token-invalid` response when issuing a request to Criteo server, the most likely reason is incorrect `client_id`/`client_secret` or an uninitialized environment.

The Postman community forum can be used for generic Postman usage questions.

If you have a question or a bug report which is specific to Criteo API, please get in touch with your Criteo contact.