Skip to main content
POST
Place an outbound call

Authorizations

Authorization
string
header
required

Your API key from the Wave dashboard. Sandbox keys start sk_sandbox_; production keys start sk_live_. Send as Authorization: Bearer <key>. Some endpoints require a production key and specific scopes.

Body

application/json
to
string
required
Pattern: ^(\+966|0)(1[1-9]\d{7}|5\d{8}|800\d{7}|9200\d{6})$
caller_id_name
string
Maximum string length: 64
caller_id_number
string
metadata
object

Response

Call initiated

call_id
string
status
enum<string>
Available options:
initiated
Example:

"initiated"

direction
string
Example:

"outbound"

to
string

Masked destination.

from
string
sandbox
boolean
created_at
string<date-time>