Skip to main content

Add Tags to Contact

Add one or more tags to an existing contact. Tags already on the contact are preserved — duplicates are ignored.


Endpoint​

POST https://api.campaignlark.com/v1/contacts/:id/tags/add

Path Parameters​

ParameterTypeRequiredDescription
idstringrequiredThe contact ID.

Request Body​

FieldTypeRequiredDescription
tag_idsarray of integersrequiredTag IDs to add to the contact. Must contain at least one ID. All IDs must exist in the workspace.

Sample Request​

POST https://api.campaignlark.com/v1/contacts/64f1a2b3c4d5e6f7a8b9c0d1/tags/add
Content-Type: application/json

{
"tag_ids": [1, 3, 5]
}

Response​

Success — 200 OK​

Returns the full updated contact object.


Automation Behaviour​

Fires TAG_ADDED automations for any tags that were not already on the contact.


Errors​

StatusMessageCause
400The contact ID you provided is not valid.id path param is missing.
400Please provide at least one tag ID to add or remove.tag_ids is empty.
400Tag ID <id> does not exist in this workspaceA provided tag ID is invalid.