---
title: "/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove"
method: POST
path: "/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove"
tags: ["Segment"]
---

# /2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove

`POST /2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `CommerceGrid_Segment_Manage`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/commerce-grid/audience-segments/:audience-segment-id/contact-list/add-remove/post.ts> (a function with typed inputs; its response is checked against the schema)

Add/remove identifiers to or from a Commerce Grid audience segment of type Contact List.

## Path parameters

- `audience-segment-id` string, int64, required

## Request body

- CommerceGridContactlistAmendmentRequest: Request of Commerce Grid contact list
  - `data` CommerceGridContactlistAmendment, required: Request data of Commerce Grid contact list amendment
    - `attributes` object, required: Attributes of Commerce Grid contact list amendment
      - `identifiers` string[], required: The users to add or remove, each in the schema specified
      - `identifierType` 'Email' | 'MadId' | 'UserIdentifier' | 'IdentityLink' | 'BidSwitchId' | 'FTrackId' | 'PanoramaId' | 'HadronId' | 'IpAddressV4' | 'PageUrl' | 'PageDomain' | 'AppId': What type of identifiers are used
      - `operation` 'Add' | 'Remove', required: Whether to add or remove users
    - `type` string: Contact List

## Response `200`

Summary of the add/remove operation of identifiers

- CommerceGridContactlistOperation: Operation on Commerce Grid contact list
  - `data` CommerceGridContactlistOperationResponseAttributes, required: Response data of Commerce Grid contact list amendment
    - `type` string, nullable: Contact List
    - `attributes` object, required: Attributes of Commerce Grid contact list amendment
      - `contactListId` integer, nullable: the affected contact list ID
      - `identifierType` string, nullable: The schema specified for of the identifiers
      - `nbInvalidIdentifiers` integer, nullable: How many identifiers were invalid for the specified schema
      - `nbValidIdentifiers` integer, nullable: How many identifiers were valid for the specified schema
      - `operation` string, required: The action recorded
      - `requestDate` string, date-time, nullable: When the action was recorded
      - `sampleInvalidIdentifiers` string[], nullable: A sample of invalid identifiers if there is some
  - `errors` AudienceError[], required
    - `code` string, required: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case.
    - `detail` string, nullable: (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem
    - `instance` string, required: (REQUIRED) A URI reference that identifies the specific occurrence of the problem
    - `source` object, nullable: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string[], nullable: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology
    - `title` string, nullable: (RECOMMENDED) A short, human-readable summary of the problem type
    - `traceId` string, nullable: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.
    - `type` 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', required: (REQUIRED) The classification of the error
  - `warnings` AudienceWarning[], required
    - `code` string, required: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case.
    - `detail` string, required: (REQUIRED) A human-readable explanation specific to this occurrence of the problem
    - `instance` string, required: (REQUIRED) A URI reference that identifies the specific occurrence of the problem
    - `source` object, nullable: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string[], nullable: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology
    - `title` string, nullable: (RECOMMENDED) A short, human-readable summary of the problem type
    - `traceId` string, nullable: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.
    - `type` 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', required: (REQUIRED) The classification of the error

---

[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)