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
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | required | The contact ID. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
tag_ids | array of integers | required | Tag 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
| Status | Message | Cause |
|---|---|---|
400 | The contact ID you provided is not valid. | id path param is missing. |
400 | Please provide at least one tag ID to add or remove. | tag_ids is empty. |
400 | Tag ID <id> does not exist in this workspace | A provided tag ID is invalid. |