---
title: "/2026-01/retail-media/accounts/{account-id}/audience-segments/create"
method: POST
path: "/2026-01/retail-media/accounts/{account-id}/audience-segments/create"
tags: ["Audience"]
---

# /2026-01/retail-media/accounts/{account-id}/audience-segments/create

`POST /2026-01/retail-media/accounts/{account-id}/audience-segments/create`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/audience-segments/create`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Audience_Manage`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/retail-media/accounts/:account-id/audience-segments/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates all segments with a valid configuration, and returns the full segments. For those that cannot be created, one or multiple errors are returned.

## Path parameters

- `account-id` string, required

## Request body

- RmAudienceSegmentBulkCreateInputV1: A top-level object that encapsulates a Criteo API request for several values.
  - `data` RmAudienceSegmentCreateEntityV1Resource[]
    - `attributes` RmAudienceSegmentCreateEntityV1: Set of rules that defines specific people to target.
      - `contactList` RmContactListCreateV1: Settings to target users with your contact lists.
        - `identifierType` 'Email' | 'UserIdentifier' | 'IdentityLink' | 'CustomerId' | 'PhoneNumber': Indicates contact list type
      - `description` string: Description of the segment
      - `events` RmEventsCreateV1: Settings to target users based on their behavior
        - `brandIds` string[]: Choose the brands your segment might be interested in
        - `categoryIds` string[]: Choose the categories your segment might be interested in
        - `lookbackDays` 'Last7Days' | 'Last14Days' | 'Last30Days' | 'Last45Days' | 'Last60Days' | 'Last90Days' | 'Last120Days' | 'Last150Days' | 'Last180Days', required: Number of days of the lookback windows
        - `maxPrice` number, double: Reach people who’ve shown interest in products with a maximum price
        - `minPrice` number, double: Reach people who’ve shown interest in products with a minimum price
        - `shopperActivity` 'View' | 'Buy' | 'AddToCart', required: Types of shopper activity.
      - `name` string, required: Name of the segment
      - `retailerId` string, required: Retailer associated to the segment
    - `type` string

## Response `200`

Success or partial success

- RmAudienceSegmentEntityV1ListResponse: A top-level object that encapsulates a Criteo API response for several entities
  - `data` RmAudienceSegmentEntityV1Resource[], nullable
    - `attributes` RmAudienceSegmentEntityV1, nullable: Set of rules that defines specific people to target.
      - `accountId` string, nullable: Account associated to the segment
      - `channels` string[], nullable: Channels associated to the segment (read-only)
      - `contactList` RmContactListV1, nullable: Settings to target users with your contact lists.
        - `identifierType` 'Unknown' | 'Email' | 'UserIdentifier' | 'IdentityLink' | 'CustomerId' | 'PhoneNumber', nullable: Indicates contact list identifier's type
        - `isReadOnly` boolean, nullable: Is the segment read-only
        - `sharingStatus` 'Unknown' | 'NotShared' | 'SharedWithAll' | 'SharedWithDemandAccounts', nullable: Indicates if the contact list is shared with other accounts
      - `createdAt` string, date-time, nullable: ISO-8601 timestamp in UTC of segment creation (read-only)
      - `createdById` string, nullable: User that created the segment
      - `description` string, nullable: Description of the segment
      - `events` RmEventsV1, nullable: Settings to target users based on their behavior
        - `brandIds` string[], nullable: The list of brand ids
        - `categoryIds` string[], nullable: The list of category ids
        - `lookbackDays` 'Unknown' | 'Last7Days' | 'Last14Days' | 'Last30Days' | 'Last45Days' | 'Last60Days' | 'Last90Days' | 'Last120Days' | 'Last150Days' | 'Last180Days', nullable: The number of days to look back
        - `maxPrice` number, double, nullable: Maximum price of the products
        - `minPrice` number, double, nullable: Minimum price of the products
        - `shopperActivity` 'Unknown' | 'View' | 'Buy' | 'AddToCart', nullable: Reach people who performed specific action
      - `name` string, nullable: Name of the segment
      - `retailerId` string, nullable: Retailer associated to the segment
      - `type` 'Unknown' | 'ContactList' | 'Events', nullable: Type of segment (read-only)
      - `updatedAt` string, date-time, nullable: ISO-8601 timestamp in UTC of segment update (read-only)
    - `id` string, nullable: Id of the entity
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `warnings` CommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)