Assign Agent to Lead
Enroll a lead into a workflow (an AI agent). If the lead has no active workflow this is an enrollment; if it already has one, that run is deactivated and replaced (reassignment). The lead starts the new workflow’s cadence unless the workflow is paused.
This does NOT set the lead’s owner. To assign a human owner, send assigned_to on PATCH /leads/ (or when creating the lead).
assigned_to on PATCH /leads/ or when creating the lead.Authorizations
API key for authentication. Keys are prefixed with nxr_live_.
Path Parameters
Lead ID
Body
ID of the workflow to assign the lead to. Use GET /workflows to list available workflows. workflowId (camelCase) is accepted as an alias.
"123e4567-e89b-12d3-a456-426614174000"
Optional reason for the assignment. Stored on the deactivated workflow run when reassigning.
"Lead qualified for premium workflow"