---
title: "Create Phone Call In Thread"
method: POST
path: "/voice/{thread_id}/phone-call"
tags: ["Voice"]
---

# Create Phone Call In Thread

`POST /voice/{thread_id}/phone-call`

## Request

- Base URL: `https://api.puppeteerai.com`
- URL: `https://api.puppeteerai.com/voice/{thread_id}/phone-call`
- Auth: none declared. Required headers: `Authorization`

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.

## Path parameters

- `thread_id` string, required

## Headers

- `Authorization` string, required

## Request body

- PhoneCallInput
  - `callee` string, required: The phone number to call. Ideally in E.164 format, otherwise parsed as a number containing a country code.
  - `project_id` string, required: The UUID of the Puppeteer project.
  - `scheduled_for` string, date-time, nullable: ISO 8601 datetime to schedule the call for a future time. If omitted, the call starts immediately.
  - `verification_code` string, nullable: Verification code from Twilio Verify
  - `appointment_opening_id` string, nullable: Appointment opening ID
  - `retell_account_id` string, nullable: The UUID of the Retell account to use. Required when the project has multiple phone numbers.

## Response `200`

Successful Response

- PublicCallInfo
  - `id` string, required: Unique identifier for the call.
  - `call_type` string, required: Type of call (e.g., "phone_call", "web_call").
  - `status` string, required: Current status of the call (e.g., "queued", "ongoing", "ended", "scheduled").
  - `to_number` string, nullable: The phone number being called (phone calls only).
  - `from_number` string, nullable: The originating phone number (phone calls only).
  - `scheduled_for` string, nullable: ISO 8601 datetime if the call is scheduled.
  - `start_timestamp` integer, nullable: Unix timestamp when the call started.
  - `end_timestamp` integer, nullable: Unix timestamp when the call ended.
  - `duration_ms` integer, nullable: Duration of the call in milliseconds.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api.md) - [All operations](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api/revisions/94b4e928b42f?raw)