HomeKnowledge BaseAPI Reference
API ReferenceSubmit a Ticket
API Reference
API ReferenceSubmit a Ticket

Add Tags to Contact

post
https://api.campaignrefinery.com/rest/contacts/add_tags

Adds one or more existing tags to a contact by UUID. Either tag_id (single tag) or tag_ids (comma-separated list) must be provided. Tag UUIDs that do not resolve to a tag in the authenticated account are reported in the 'skipped' response array; resolved tags are returned by name in 'added' (asymmetric -- 'added' contains names, 'skipped' contains UUIDs). The legacy singular path /contacts/add_tag also accepts the same payload as an undocumented alias.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid
required

The contact UUID.

uuid

Single tag UUID. Required if tag_ids is not sent. IMPORTANT: this is the tag UUID, not the tag name.

string

Comma-separated list of tag UUIDs. Required if tag_id is not sent. Each entry is validated as a UUID; invalid entries return 422 with field keys 'tag_ids.0', 'tag_ids.1', etc.

Responses

401

Missing or invalid bearer token.

Updated 3 months ago

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

Updated 3 months ago