Sign in
Calls

Dev Init Call

Initialize a call record for local development (DEV ENVIRONMENT ONLY).

This endpoint allows local bot development without going through Twilio webhooks. It creates a call record with test defaults and returns the call_id that the bot can use to finalize the call information via PATCH /calls/{call_id}.

Only available in development environment (app_env=dev). Requires a per-customer agent token for authentication.

Defaults applied:

  • is_test=True
  • phone_number="+15555551234" (if not provided)
  • direction="inbound" (if not provided)
  • start_time=now
  • session_id=auto-generated dev session ID

Returns:

  • call_id: The UUID of the created call record
  • call: Full call object with all details
post/calls/dev-init

Request body

directionstring nullable

Direction of the call: 'inbound' or 'outbound'

phone_numberstring nullable

Phone number associated with the call (defaults to +15555551234)

Response

Successful Response

call_idstring uuid required

The ID of the created call record

Changes