---
title: "Create Patient Batch Calls"
method: POST
path: "/api/v0/patient-calls/batch-calls"
---

# Create Patient Batch Calls

`POST /api/v0/patient-calls/batch-calls`

## Headers

- `Idempotency-Key` string

## Request body

- ExternalPatientCallRequest[]
  - `type` 'PATIENT_OUTREACH' — An enumeration.
  - `patient_name` string, required — Name of the patient to call
  - `patient_phone` string, required — Phone number to dial. E.164 format preferred (e.g. +14155552671).
  - `desired_call_ts` string, date-time — When to place the call, as an ISO 8601 timestamp. If omitted, the call is scheduled to start within the next 5 minutes.
  - `call_script_id` string, required — ID of a call script belonging to your team. Create and manage scripts in the dashboard under Call Scripts. The script defines the questions asked when the patient answers live.
  - `voice` 'KRISPIN' | 'RONALD' | 'PRIYA' | 'DEVANSH', required — Curated Cartesia voices available for patient calls. Friendly names map to internal Cartesia voice IDs when dialing is activated.
  - `external_id` string — Optional identifier you define for tracking (e.g. provider or campaign id).
  - `metadata` object — Key/value pairs available to the agent while it runs the call script during the live call (e.g. medication name, appointment time). Also returned on the call response and webhooks.
  - `leave_voicemail_if_no_answer` boolean — If true, leave a voicemail when the patient does not answer. Voicemail is a fallback for unanswered calls, not a separate product.
  - `voicemail_script` string — Message to leave if leave_voicemail_if_no_answer is true. Required when leave_voicemail_if_no_answer is true once the API is activated.

## Response `200`

Successful Response

- PatientCallCreationResponse[]
  - `success` boolean, required
  - `call_id` string
  - `already_existed` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/healthharbor/apis/health-harbor.md) · [All operations](https://skmtc.net/healthharbor/apis/health-harbor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/healthharbor/health-harbor/revisions/f1047899ad24/schema)