Skip to main content
POST
Assign Leads to an Agent in Bulk
Notas de seguridad y comportamiento
  • Cada lead aceptado desactiva su ejecución actual, recibe una nueva y comienza la cadencia, lo que puede iniciar contacto saliente real.
  • Los fallos por lead se devuelven dentro de HTTP 200 con success=false; revisa failed en cada solicitud.
  • El cuerpo de la solicitud realiza asignaciones reales y masivas de workflow al enviarse.
  • REST directo se ejecuta de inmediato y no tiene campos dry_run ni confirm.
  • Revisa el conjunto completo de leads y el workflow de destino antes de enviar la operación.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Cuerpo

application/json
lead_ids
any[]
requerido
Required array length: 1 - 500 elements

The route accepts any JSON item structurally. Only UUID strings are processed; every other item is returned in failed[].

workflow_id
string<uuid>
requerido
workflowId
string<uuid>
reason
string
predeterminado:api_assignment

Respuesta

Batch always returns 200 after workflow validation; success=false means one or more per-lead failures.

success
boolean
requerido
total
integer
requerido
Rango requerido: 1 <= x <= 500
assigned
integer
requerido
Rango requerido: x >= 0
workflow_id
string<uuid>
requerido
failed
object[]
requerido
Última modificación el 8 de septiembre de 2026