---
title: "/2026-01/marketing-solutions/audience-segments/create"
method: POST
path: "/2026-01/marketing-solutions/audience-segments/create"
tags: ["Audience"]
---

# /2026-01/marketing-solutions/audience-segments/create

`POST /2026-01/marketing-solutions/audience-segments/create`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/marketing-solutions/audience-segments/create`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `MarketingSolutions_Audience_Manage`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/marketing-solutions/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 their IDs. For those that cannot be created, one or multiple errors are returned.

## Request body

- AudienceSegmentBulkCreateInputV1: Input to create one or more audience segments.
  - `data` AudienceSegmentCreateEntityV1Resource[]
    - `attributes` AudienceSegmentCreateEntityV1: Set of rules that defines specific people to target.
      - `advertiserId` string, required: Advertiser associated to the segment
      - `contactList` ContactListCreateV1: Settings to target users with your contact lists.
      - `description` string: Description of the segment
      - `inMarket` InMarketCreateV1: Settings to target users based on high shopping intents and demographics.
        - `brandIds` string[]: Choose the brands your segment might be interested in
        - `buyingPower` string[]: Reach people who frequently purchase high price range items to lower price range items
        - `country` string, required: Reach people of a specific country
        - `gender` 'Male' | 'Female': Reach people who’ve shown interest in products made for a specific gender
        - `interestIds` string[]: Reach new people based on their interests
        - `priceRange` string[]: Reach people who’ve shown interest in products within a specific price range
      - `location` LocationCreateV1: Settings to target users based on their location.
        - `pointsOfInterest` PointOfInterestV1[], required: Reach users which have been historically located in the given coordinates
          - `latitude` number, double, nullable: ISO-6709 latitude (rounded at 5 decimals)
          - `longitude` number, double, nullable: ISO-6709 longitude (rounded at 5 decimals)
          - `name` string, nullable: Name of the point of interest
        - `radiusInKm` integer, required: The expected maximum distance in kilometers between a user and a point of interest
      - `lookalike` LookalikeCreateV1: Settings to target users close to a given seed segment.
        - `seedSegmentId` string, required: Segment from which the Lookalike segment will be generated
        - `targetSize` integer: Desired size of the generated Lookalike segment
      - `name` string, required: Name of the segment
      - `prospecting` ProspectingCreateV1: Settings to target prospecting users to website visitors.
        - `daysSinceLastVisitMax` integer: When non buyers are included, include users who visited your website after this number of days
        - `daysSinceLastVisitMin` integer: When non buyers are included, include users who visited your website before this number of days
        - `usersType` 'Prospects' | 'ProspectsOrNonBuyers', required: Type of users to target
      - `retargeting` RetargetingCreateV1: Settings to target users based on its type and days since last visit.
        - `daysSinceLastVisitMax` integer, required: Maximum number of days since last visit to partner.
        - `daysSinceLastVisitMin` integer, required: Minimum number of days since last visit to partner.
        - `visitorsType` 'All' | 'Buyers' | 'NonBuyers', required: Types of visitors.
    - `type` string

## Response `200`

Success or partial success

- AudienceSegmentEntityV1ListResponse: A top-level object that encapsulates a Criteo API response for several entities
  - `data` AudienceSegmentEntityV1Resource[], nullable
    - `attributes` AudienceSegmentEntityV1, nullable: Set of rules that defines specific people to target.
      - `advertiserId` string, nullable: Advertiser associated to the segment
      - `behavioral` BehavioralV1, nullable: Settings of a behavioral set of users provided by Criteo.
        - `category` 'Unknown' | 'Lifestyles' | 'LifeEvents' | 'Seasonal' | 'BuyingPatterns', required: The type of behavioral
        - `country` string, nullable: The users' country
        - `endDate` string, date-time, nullable: Desired date when the behavioral will end
        - `startDate` string, date-time, nullable: Desired date when the behavioral will start
      - `contactList` ContactListV1, nullable: Settings to target users with your contact lists.
        - `isReadOnly` boolean, nullable: Is the segment read-only
      - `createdAt` string, date-time, nullable: ISO-8601 timestamp in UTC of segment creation (read-only)
      - `description` string, nullable: Description of the segment
      - `inMarket` InMarketV1, nullable: Settings to target users based on high shopping intents and demographics.
        - `brandIds` string[], nullable: Choose the brands your segment might be interested in
        - `buyingPower` string[], nullable: Reach people who frequently purchase high price range items to lower price range items
        - `country` string, nullable: Reach people of a specific country
        - `gender` 'Unknown' | 'Male' | 'Female', nullable: Reach people who’ve shown interest in products made for a specific gender
        - `interestIds` string[], nullable: Reach new people based on their interests
        - `priceRange` string[], nullable: Reach people who’ve shown interest in products within a specific price range
      - `location` LocationV1, nullable: Settings to target users based on their location.
        - `pointsOfInterest` PointOfInterestV1[], nullable: Reach users which have been historically located in the given coordinates
          - `latitude` number, double, nullable: ISO-6709 latitude (rounded at 5 decimals)
          - `longitude` number, double, nullable: ISO-6709 longitude (rounded at 5 decimals)
          - `name` string, nullable: Name of the point of interest
        - `radiusInKm` integer, nullable: The expected maximum distance in kilometers between a user and a point of interest
        - `registryType` 'Unknown' | 'PointOfInterest', nullable: The kind of Location audience
      - `lookalike` LookalikeV1, nullable: Settings to target users that behave like a given seed segment
        - `seedSegmentId` string, nullable: Segment from which the Lookalike segment will be generated
        - `targetSize` integer, nullable: Desired size of the generated Lookalike segment
      - `name` string, nullable: Name of the segment
      - `prospecting` ProspectingV1, nullable: Settings to target prospecting users to website visitors.
        - `daysSinceLastVisitMax` integer, nullable: When non buyers are included, include users who visited your website after this number of days
        - `daysSinceLastVisitMin` integer, nullable: When non buyers are included, include users who visited your website before this number of days
        - `usersType` 'Unknown' | 'Prospects' | 'ProspectsOrNonBuyers', nullable: Type of users to target
      - `retargeting` RetargetingV1, nullable: Settings to target users based on its type and days since last visit.
        - `daysSinceLastVisitMax` integer, nullable: Maximum number of days since last visit to partner.
        - `daysSinceLastVisitMin` integer, nullable: Minimum number of days since last visit to partner.
        - `visitorsType` 'Unknown' | 'All' | 'Buyers' | 'NonBuyers', nullable: Types of visitors.
      - `type` 'Unknown' | 'InMarket' | 'Prospecting' | 'ContactList' | 'Location' | 'Behavioral' | 'Retargeting' | 'Lookalike', 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)