> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # /2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove > Add/remove identifiers to or from a Commerce Grid audience segment of type Contact List. ## OpenAPI ````yaml https://api.criteo.com/2026-01/commercegrid/open-api-specifications.json post /2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove openapi: 3.0.1 info: title: Criteo API description: Criteo API - CommerceGrid version: 2026-01 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Gateway - name: Segment paths: /2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove: post: tags: - Segment summary: >- /2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove description: >- Add/remove identifiers to or from a Commerce Grid audience segment of type Contact List. operationId: AddRemoveContactListByAudienceSegment parameters: - name: audience-segment-id in: path description: The ID of the audience segment of type contact list to amend required: true schema: type: string format: int64 requestBody: content: application/json: schema: $ref: '#/components/schemas/CommerceGridContactlistAmendmentRequest' required: true x-bodyName: body responses: '200': description: Summary of the add/remove operation of identifiers content: application/json: schema: $ref: '#/components/schemas/CommerceGridContactlistOperation' example: data: type: AddRemoveContactlistResult attributes: contactListId: 568708742535471100 operation: add requestDate: '2018-12-10T10:00:50.0000000+00:00' identifierType: madid nbValidIdentifiers: 7343 nbInvalidIdentifiers: 13 sampleInvalidIdentifiers: - InvalidIdentifier errors: - traceId: 667ac683ac797284.667ac683ac797284<:667ac683ac797284 type: availability code: internal-error instance: '' title: Internal error warnings: - traceId: 56ed4096-f96a-4944-8881-05468efe0ec9 type: deprecation code: deprecated-field instance: /audiences/314195 title: '''nbValidIds'' is deprecated' detail: >- The field 'nbValidIds' is deprecated please use 'nbValidIdentifiers' security: - oauth: - CommerceGrid_Segment_Manage components: schemas: CommerceGridContactlistAmendmentRequest: required: - data type: object properties: data: $ref: '#/components/schemas/CommerceGridContactlistAmendment' description: Request of Commerce Grid contact list CommerceGridContactlistOperation: required: - data - errors - warnings type: object properties: data: $ref: >- #/components/schemas/CommerceGridContactlistOperationResponseAttributes errors: type: array items: $ref: '#/components/schemas/AudienceError' warnings: type: array items: $ref: '#/components/schemas/AudienceWarning' description: Operation on Commerce Grid contact list CommerceGridContactlistAmendment: required: - attributes type: object properties: attributes: required: - identifiers - operation type: object properties: identifiers: type: array items: type: string description: The users to add or remove, each in the schema specified identifierType: enum: - Email - MadId - UserIdentifier - IdentityLink - BidSwitchId - FTrackId - PanoramaId - HadronId - IpAddressV4 - PageUrl - PageDomain - AppId type: string description: What type of identifiers are used operation: enum: - Add - Remove type: string description: Whether to add or remove users description: Attributes of Commerce Grid contact list amendment type: type: string description: Contact List example: AddRemoveContactlist description: Request data of Commerce Grid contact list amendment CommerceGridContactlistOperationResponseAttributes: required: - attributes properties: type: type: string description: Contact List nullable: true example: AddRemoveContactlist attributes: required: - operation type: object properties: contactListId: type: integer description: the affected contact list ID format: int64 nullable: true readOnly: true identifierType: type: string description: The schema specified for of the identifiers nullable: true readOnly: true nbInvalidIdentifiers: type: integer description: How many identifiers were invalid for the specified schema format: int32 nullable: true readOnly: true nbValidIdentifiers: type: integer description: How many identifiers were valid for the specified schema format: int32 nullable: true readOnly: true operation: type: string description: The action recorded requestDate: type: string description: When the action was recorded format: date-time nullable: true readOnly: true sampleInvalidIdentifiers: type: array items: type: string description: A sample of invalid identifiers if there is some nullable: true readOnly: true description: Attributes of Commerce Grid contact list amendment description: Response data of Commerce Grid contact list amendment AudienceError: required: - code - instance - type type: object properties: code: type: string description: >- (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case. detail: type: string description: >- (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: >- (REQUIRED) A URI reference that identifies the specific occurrence of the problem source: type: object description: >- (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: array items: type: string description: >- (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology nullable: true title: type: string description: (RECOMMENDED) A short, human-readable summary of the problem type nullable: true traceId: type: string description: >- (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem. nullable: true type: enum: - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: (REQUIRED) The classification of the error description: Definition of an audience error AudienceWarning: required: - code - detail - instance - type type: object properties: code: type: string description: >- (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case. detail: type: string description: >- (REQUIRED) A human-readable explanation specific to this occurrence of the problem instance: type: string description: >- (REQUIRED) A URI reference that identifies the specific occurrence of the problem source: type: object description: >- (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: array items: type: string description: >- (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology nullable: true title: type: string description: (RECOMMENDED) A short, human-readable summary of the problem type nullable: true traceId: type: string description: >- (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem. nullable: true type: enum: - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: (REQUIRED) The classification of the error description: Definition of the warning securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````