Saltar al contenido principal
POST /leads/:leadId/tags Asigna una o más etiquetas a un lead. Acepta un solo ID de etiqueta o un array de IDs de etiquetas. Las etiquetas ya asignadas se omiten silenciosamente.

​
Parámetros de Ruta

ParámetroTipoDescripción
leadIdstring (uuid)ID del lead al que se asignarán las etiquetas

​
Cuerpo de la Solicitud

CampoTipoRequeridoDescripción
tagIdstring (uuid)Sí*Un solo ID de etiqueta a asignar
tagIdsstring[] (uuid)Sí*Un array de IDs de etiquetas a asignar
* Proporciona tagId o tagIds, no ambos.

​
Ejemplos

​
Asignar una sola etiqueta

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"
  }'

​
Asignar múltiples etiquetas

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"
    ]
  }'

​
Respuestas

​
201 — Etiquetas asignadas exitosamente

{
  "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 — Error de autenticación

Ver Autenticación.

​
500 — Error interno del servidor

Última modificación el 18 de junio de 2026