Skip to main content
POST
/
api
/
v1
/
create-phone-call
Create phone call
curl --request POST \
  --url https://voxworks.ai/api/v1/create-phone-call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_number": "+61291234567",
  "script_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "contact": {
    "phone_number": "0429069971",
    "first_name": "John",
    "last_name": "Smith"
  },
  "scheduled_time": "2026-02-25T09:00:00Z"
}
'
{
  "success": true,
  "call_id": "<string>",
  "contact_id": "<string>",
  "status": "scheduled"
}

Documentation Index

Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key from Voxworks, sent as Authorization: Bearer YOUR_API_KEY.

Body

application/json
from_number
string
required

Phone number to call from. Must belong to your team.

script_id
string
required
contact
object
required
objects
object

Object data keyed by object type name.

scheduled_time
string<date-time>

ISO 8601 timestamp. Defaults to now.

Response

Call scheduled.

success
boolean
required
Example:

true

call_id
string
required
contact_id
string
required
status
string
required
Example:

"scheduled"