GEgetpuppeteer
Voice

Create Phone Call In Thread

Create a phone call for the specified thread. The callee number is parsed and validated, and the call is initiated or scheduled based on the input.

post/voice/{thread_id}/phone-call

Request

  • Base URL
    https://api.puppeteerai.com
  • Auth
    none declared. Required headers: Authorization

Path parameters

thread_idstring required

Headers

Authorizationstring required

Request body

calleestring required

The phone number to call. Ideally in E.164 format, otherwise parsed as a number containing a country code.

project_idstring required

The UUID of the Puppeteer project.

scheduled_forstring date-time nullable

ISO 8601 datetime to schedule the call for a future time. If omitted, the call starts immediately.

verification_codestring nullable

Verification code from Twilio Verify

appointment_opening_idstring nullable

Appointment opening ID

retell_account_idstring nullable

The UUID of the Retell account to use. Required when the project has multiple phone numbers.

Response

Successful Response

idstring required

Unique identifier for the call.

call_typestring required

Type of call (e.g., "phone_call", "web_call").

statusstring required

Current status of the call (e.g., "queued", "ongoing", "ended", "scheduled").

to_numberstring nullable

The phone number being called (phone calls only).

from_numberstring nullable

The originating phone number (phone calls only).

scheduled_forstring nullable

ISO 8601 datetime if the call is scheduled.

start_timestampinteger nullable

Unix timestamp when the call started.

end_timestampinteger nullable

Unix timestamp when the call ended.

duration_msinteger nullable

Duration of the call in milliseconds.

Changes

No recorded changes to this operation across all 1 revision of this API.