---
title: "/2026-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list"
method: PATCH
path: "/2026-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list"
tags: ["Audience"]
---

# /2026-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list

`PATCH /2026-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list`

Add/remove identifiers to or from a contact list audience-segment.

## Request body

- ContactlistAmendmentRequest — Request for a contactlist amendment
  - `data` ContactlistAmendment, required — Parameters for the amendment of a contactlist
    - `attributes` object, required — the name of the entity type
      - `gumCallerId` integer — The Gum caller id of the advertiser patching identifiers of type Gum
      - `identifiers` string[], required — The users to add or remove, each in the schema specified
      - `identifierType` 'email' | 'madid' | 'identityLink' | 'gum' | 'phoneNumber' — What type of identifiers are used
      - `operation` 'add' | 'remove', required — Operation to add or remove users
    - `type` string, required — User List

## Response `200`

Summary of created request

- ModifyAudienceResponse — Parameters to modify an audience
  - `data` ContactlistOperation, required — Response definition of a contactlist operation
    - `attributes` object, required — the contactlist operation attributes
      - `contactListId` integer, nullable — the affected user 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
    - `type` string, required — the name of the entity type
  - `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.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/revisions/c1721589426a/schema)