---
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`

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.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/versions/c1721589426a/schema)