Create leads

Create one or more leads and assign them to a voice agent.

post/api/v1/public/agents/{agent_id}/leads

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

agent_id*Agent Id

Request Body

application/json

name*Name

Length1 <= length <= 120

email*Email

Length3 <= length <= 254

phone*Phone

Length4 <= length <= 32

description*Description

Length1 <= length <= 1000

Example request

curl -X POST "https://example.com/api/v1/public/agents/string/leads" \  -H "Content-Type: application/json" \  -d '{    "name": "<string>",    "email": "customer@example.com",    "phone": "+15551234567",    "description": "<string>"  }'

[  {    "id": "<id>",    "agentId": "string",    "campaignId": "string",    "name": "<string>",    "email": "string",    "phone": "string",    "description": "string",    "customFields": null,    "source": "string",    "status": "string",    "externalSource": "string",    "externalRef": "string",    "createdAt": "2026-01-15T10:30:00Z",    "updatedAt": "2026-01-15T10:30:00Z"  }]

{  "detail": [    {      "loc": [        "string"      ],      "msg": "<string>",      "type": "<string>",      "input": null,      "ctx": {}    }  ]}