[Audiences] Managing Audiences

Creating A New Audience

A new audience can be created for a specific advertiser by making a POST call to the audience user list endpoint. The payload should specify the advertiser id as well as the name and description of the new audience.

https://api.criteo.com/legacy/marketing/v1/audiences/userlist

curl --request POST \
  --url https://api.criteo.com/legacy/marketing/v1/audiences/userlist \
  --header 'Accept: application/json' \
  --header 'Content-Type: text/json' \
  --data '{"advertiserId":1234,"name":"Store Visitors","description":"Users who have visited a store"}'

The API will return a unique audience id associated with the newly created audience.

{
  "audienceId": 7654
}

Deleting An Audience

An audience can be deleted by specifying the audience id in the URL path of a DELETE call to the audiences endpoint.

https://api.criteo.com/legacy/marketing/v1/audiences/{audienceId}

curl --request DELETE \
  --url https://api.criteo.com/legacy/marketing/v1/audiences/7654 \
  --header 'Accept: application/json'

The API will not return a response message. A 204 HTTP status code will be returned to confirm that the audience has been deleted.

Updating Audience Metadata

The audience name and description can be updated by making a PUT call to the audiences endpoint with a specific audience id in the URL path. The payload should include the updated name and description.

https://api.criteo.com/legacy/marketing/v1/audiences/{audienceId}

curl --request PUT \
  --url https://api.criteo.com/legacy/marketing/v1/audiences/1234 \
  --header 'Accept: application/json' \
  --header 'Content-Type: text/json' \
  --data '{"name":"Store Visitors - Past Week","description":"Users who have visited a store in the past week"}'

The API will not return a response message. A 204 HTTP status code will be returned to confirm that the audience data has been updated.