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.