Batch add tags

Adds the specified tags to 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 union of all matched contacts is tagged:
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 tagged once. Emails and phones with no matching contact are silently ignored.
Tagging is performed asynchronously, so the tags may not be visible immediately.

Scopes:
contacts.write

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

Body Params

Contact selectors and tags to add

Payload for batch adding tags to contacts.

contactIDs
array of strings
length ≤ 250

Contact IDs to add tags to

contactIDs
emails
array of strings
length ≤ 250

Emails of contacts to add tags to

emails
phones
array of strings
length ≤ 250

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

phones
string

Segment ID whose contacts get the tags

tags
array of strings
required
length between 1 and 100

Tags to add

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

API version that specifies the response format and behaviour

Responses
202

Tagging accepted

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