Assign Lead Tags
/leads/:leadId/tags
Assign one or more tags to a lead. Accepts either a single tag ID or an array of tag IDs. Already-assigned tags are silently skipped.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
leadId | string (uuid) | The lead ID to assign tags to |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
tagId | string (uuid) | Yes* | A single tag ID to assign |
tagIds | string[] (uuid) | Yes* | An array of tag IDs to assign |
* Provide either tagId or tagIds, not both.
Examples
Assign a single tag
curl -X POST https://api.getnexor.ai/api/public/leads/123e4567-e89b-12d3-a456-426614174000/tags \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{
"tagId": "123e4567-e89b-12d3-a456-426614174001"
}'
Assign multiple tags
curl -X POST https://api.getnexor.ai/api/public/leads/123e4567-e89b-12d3-a456-426614174000/tags \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{
"tagIds": [
"123e4567-e89b-12d3-a456-426614174001",
"123e4567-e89b-12d3-a456-426614174002"
]
}'
Responses
201 — Tags assigned successfully
{
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174001",
"name": "VIP Client",
"slug": "vip-client"
},
{
"id": "123e4567-e89b-12d3-a456-426614174002",
"name": "Hot Lead",
"slug": "hot-lead"
}
]
}
401 — Authentication error
See Authentication.