Callens

Submit a call

POST
/calls

Authorization

ApiKey ingest
AuthorizationBearer <token>

Authorization: Bearer clk_{tenant_id}_{secret}. The header X-Api-Key carrying the same value is also accepted, for integration platforms that cannot set an Authorization header. Keys are minted in the Callens dashboard.

In: header

Scope: ingest

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Every call names the employee it belongs to. Send exactly one of employee_code and employee_id. A request that sends neither, or both, is refused with 422.

Every call names the employee it belongs to. Send exactly one of employee_code and employee_id. A request that sends neither, or both, is refused with 422.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/calls" \  -H "Content-Type: application/json" \  -d '{    "mode": "upload",    "upload_ticket": "eyJpdiI6…",    "started_at": "2026-08-05T09:14:00Z",    "employee_code": "EMP-1042",    "provider": "zoom",    "provider_call_id": "CA123",    "idempotency_key": "CA123"  }'
{  "success": true,  "message": "Call already ingested.",  "data": {    "id": "string",    "status": "string"  }}