Sign in

v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB
Call control

Start a call

Places an outbound call. Returns the call with its uuid for tracking and control.

post/v1/calls

Request body

fromstring required

Caller ID. Must be an active or verified phone number on the account.

tostring required

Destination number in E.164 format

callback_urlstring required

The callback URL where Wavix sends the call status updates

recordingboolean

Specifies whether to record the call

voicemail_detectionboolean

Specifies whether the AMD is turned on for the call

tagstring

Call metadata

timeoutinteger

The ring timeout, in seconds, before the call is considered unanswered.

Example request

{
  "from": "+1234567890",
  "to": "+1987654321",
  "callback_url": "https://examples.com/callback",
  "tag": "marketing-campaign",
  "timeout": 60
}

Response

Returns the created call.

uuidstring uuid

Call ID. Deprecated — use id instead.

idstring uuid

Call ID. Alias of uuid.

direction'inbound' | 'outbound'

Direction of the call. One of inbound (call received by the account) or outbound (call placed by the account).

event_type'call_setup' | 'ringing' | 'early_media' | 'answered' | 'completed' | 'busy' | 'cancelled' | 'rejected' | 'on_call_event'

Most recent lifecycle event for the call. One of:

  • call_setup — the call is being initiated.
  • ringing — the destination is ringing.
  • early_media — early media (such as ringback) is playing before answer.
  • answered — the destination answered the call.
  • completed — the call ended normally.
  • busy — the destination was busy.
  • cancelled — the call was cancelled before answer.
  • rejected — the destination rejected the call.
  • on_call_event — an in-call event occurred (see event_payload).
event_timestring date-time

Date and time of the latest event

fromstring

Caller ID

tostring

Destination number

call_startedstring date-time

Date and time when the call started

call_answeredstring date-time nullable

Date and time when the call was answered

call_completedstring date-time nullable

Date and time when the call ended

machine_detectedboolean

Indicates whether the call was answered by an answering machine

tagstring

Call metadata

Example response

{
  "uuid": "5dccb6b0-f35c-488c-867b-86fb012c4415",
  "id": "5dccb6b0-f35c-488c-867b-86fb012c4415",
  "event_type": "call_setup",
  "event_time": "2025-09-22T12:56:38.547Z",
  "event_payload": {
    "type": "audio",
    "payload": {
      "status": "completed",
      "playback_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  },
  "from": "+18045961058",
  "to": "17653889567",
  "call_started": "2025-09-22T12:56:38.547Z"
}