Batch remove tags

Removes the specified tags from contacts selected by contact IDs, emails, phone numbers or a segment.
At least one of contactIDs, emails, phones or segmentID is required.
Selectors can be combined and are applied additively — the tags are removed from the union of all
matched contacts: every contact in contactIDs, every contact matched by an address in emails,
every contact matched by a number in phones and every member of segmentID. A contact matched by
more than one selector is processed once. Emails and phones with no matching contact are silently ignored.
Untagging is performed asynchronously, so the tags may not disappear immediately.

Scopes:
contacts.write

Rate Limiting:
This endpoint is rate limited to 60 requests per minute.

Body Params

Contact selectors and tags to remove

Payload for batch removing tags from contacts.

contactIDs
array of strings
length ≤ 250

Contact IDs to remove tags from

contactIDs
emails
array of strings
length ≤ 250

Emails of contacts to remove tags from

emails
phones
array of strings
length ≤ 250

Phone numbers of contacts to remove tags from, in E.164 format

phones
string

Segment ID whose contacts lose the tags

tags
array of strings
required
length between 1 and 100

Tags to remove

tags*
Headers
string
required
Defaults to 2026-03-15

API version that specifies the response format and behaviour

Responses
202

Untagging accepted

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json