Create appointment
Schedules a new appointment linking a patient to a provider at a specific time. Supports in-person and telehealth visit types.
Last updated
POST
/v1/appointmentsCreate appointments from your scheduling UI, patient portal, or automated reminder flows. The API validates provider availability server-side and rejects double-bookings with a descriptive 409 response.
POST
/v1/appointmentsAuth requiredBooks a new appointment and returns the scheduled record.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| patient_id | body | string | Yes | Patient to schedule. |
| provider_id | body | string | Yes | Rendering provider. |
| scheduled_at | body | timestamp | Yes | Start time as Unix timestamp (UTC). |
| duration_minutes | body | integer | No | Defaults to provider template or 30. |
| visit_type | body | enum | No | in_person | telehealth |
Requestjson
{
"patient_id": "pat_8Kx2mN1qRt",
"provider_id": "prv_2Qx9kLm4pZ",
"scheduled_at": 1720137600,
"duration_minutes": 45,
"visit_type": "telehealth"
}Responsejson
{
"id": "apt_7Mn3pQ9sRw",
"status": "scheduled",
"telehealth_url": "https://visit.vcaremd.com/join/abc123"
}Was this page helpful?
Your feedback helps us improve our documentation.