Skip to main content
POST
Place a draft test call
Requires a Labs super_user OAuth bearer token plus Editor, Admin, or Owner. Send numeric workflow_id and a destination phone_number, or use the saved test number. Optionally select a workspace telephony configuration and caller number. This places a real call and can incur charges. Missing telephony configuration returns 400, unknown agent 404, missing execution owner 409, and insufficient quota 402. The response contains a confirmation message with the run name; it does not return a numeric run ID. Use run listings to inspect the call. Acceptance is not proof the recipient answered.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Body

application/json
workflow_id
integer
required
from_phone_number_id
integer | null
phone_number
string | null
telephony_configuration_id
integer | null
workflow_run_id
integer | null

Response

Successful Response

message
string
required