Skip to main content
POST /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

ParameterTypeDescription
leadIdstring (uuid)The lead ID to assign tags to

​
Request Body

FieldTypeRequiredDescription
tagIdstring (uuid)Yes*A single tag ID to assign
tagIdsstring[] (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.

​
500 — Internal server error

Last modified on June 18, 2026