Create call

Starts a call on behalf of the user in the path. The body takes one of two shapes, selected by dial-rule-application:

Dial a number (omit dial-rule-application, or send call). The platform rings the first party in call-orig-user, by default the user in the path, and dials call-term-user once it answers. Send synchronous=yes to wait up to 10 seconds for the call to appear: the response is then 200 with the call. Otherwise, or if the call has not appeared by then, the response is 202.

Record an audio file (dial-rule-application is record). The platform rings call-term-user so its user can record the greeting, music on hold file, or message named by call-record-type and call-record-index. The response is always 202.

Requires Basic User scope for your own user, Office Manager scope for a user in your own domain, or Reseller or Super User scope.

Basic User, Advanced User, Simple User, and Call Center Agent tokens can start the first leg only from their own user or one of their own devices. An outside number or a SIP address outside the domain is allowed as the first leg.

Keep the call-id you send: it is the {callid} that reads, transfers, holds, and ends the call.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//calls' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "call-id": "k3m9xq2wz7pd4rtv", "call-term-user": "15555550100", "call-orig-user": "1001@example.com", "caller-id-number": "15555550101" }'

{ "call-orig-call-id": "k3m9xq2wz7pd4rtv", "call-term-call-id": "h8c2v5n1b6q0z4ma", "call-orig-user": "1001", "call-orig-domain": "example.com", "call-orig-name": "Front Desk", "call-orig-uri": "sip:1001@example.com", "call-orig-match-uri": "sip:1001@example.com", "call-through-action": "CallRequest", "call-through-user": "1001", "call-through-domain": "example.com", "call-through-name": "Front Desk", "call-through-call-id": "k3m9xq2wz7pd4rtv", "call-term-user": "1002", "call-term-domain": "example.com", "call-term-name": "Support Line", "call-term-uri": "sip:1002@example.com", "caller-id-number": "15555550100", "call-dialed-number": "1002", "call-start-datetime": "2026-09-01T14:30:00+00:00", "call-answer-datetime": null, "duration": 2, "call-orig-info": "Talking", "call-term-info": "Talking", "call-session-id": "20260901143000012345", "call-audio-codec": "PCMU", "core-server": "core1.example.com" }

Request

Responses