PATCH
/leads/tags
Sincroniza el conjunto completo de tags asignados a un lead. El cuerpo de la solicitud se trata como la fuente de verdad:
- Tags presentes en
tags que el lead no tiene son creados (buscar o crear por slug) y asignados.
- Tags actualmente asignados al lead que están ausentes de
tags son desasignados.
- Envía
"tags": [] para eliminar todos los tags del lead.
El lead puede ser identificado por lead_id o email. Los tres campos (lead_id, email, tags) también pueden estar anidados en cualquier parte del cuerpo de la solicitud. El servidor los encontrará automáticamente.
Autentica cada solicitud con el header X-API-Key. Ver Autenticación.
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|
lead_id | string (uuid) | Sí* | ID del lead |
email | string | Sí* | Email del lead (insensible a mayúsculas) |
tags | string[] | Sí | Lista completa de nombres de tags que deben estar activos en el lead. Los tags faltantes se desasignan; nombres nuevos se crean. Usa [] para eliminar todos los tags. |
lead_id o email. Si ambos están presentes, lead_id tiene precedencia.
Ejemplos
Sincronizar por lead_id
curl -X PATCH https://api.getnexor.ai/api/public/leads/tags \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{
"lead_id": "123e4567-e89b-12d3-a456-426614174000",
"tags": ["VIP", "Follow-up"]
}'
Sincronizar por email
curl -X PATCH https://api.getnexor.ai/api/public/leads/tags \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{
"email": "tony.stark@gmail.com",
"tags": ["Hot Lead"]
}'
curl -X PATCH https://api.getnexor.ai/api/public/leads/tags \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{
"lead_id": "123e4567-e89b-12d3-a456-426614174000",
"tags": []
}'
Respuestas
{
"success": true,
"lead_id": "123e4567-e89b-12d3-a456-426614174000",
"tags": [
{
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"name": "VIP",
"slug": "vip"
},
{
"id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"name": "Follow-up",
"slug": "follow-up"
}
],
"added": ["aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"],
"removed": ["cccccccc-cccc-cccc-cccc-cccccccccccc"]
}
| Campo | Descripción |
|---|
tags | Conjunto completo de tags actual después de la sincronización |
added | IDs de tags recién asignados por esta solicitud |
removed | IDs de tags desasignados por esta solicitud |
400 Error de validación
Retornado cuando tags no es un array, o cuando ni lead_id ni email se proporcionan.
401 Error de autenticación
Ver Autenticación.
404 Lead no encontrado
Retornado cuando el lead no existe o no pertenece a tu cuenta.
500 Error interno del servidor
Última modificación el 18 de junio de 2026
