Calls

Record an inbound SDK call (phone to browser)

POST
/api/calls/sdk/inbound

Persists a Call record (status answered) for an inbound PSTN call routed to the user's browser via the active voice provider's SDK. Looks up or creates a contact by caller number and links a voice Conversation. Emits the call_answered socket event to the call owner only, plus an org-wide call_activity refresh event (contactId/conversationId only) when a contact is resolved.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/calls/sdk/inbound" \  -H "Content-Type: application/json" \  -d '{    "callerNumber": "+14165550199"  }'
{  "success": true,  "call": {    "_id": "64f0a1b2c3d4e5f6a7b8cb00",    "callId": "64f0a1b2c3d4e5f6a7b8cb00",    "provider": "sinch",    "direction": "outbound",    "status": "initiated",    "from": "+14165550100",    "to": "+14165550199"  },  "message": "Call recorded"}