Skip to main content
POST
Create a patient

Authorizations

Authorization
string
header
required

API key issued by VitaRelay. Send as Authorization: Bearer vr_live_… (production) or Authorization: Bearer vr_test_… (sandbox).

Body

application/json
first_name
string
required
last_name
string
required
dob
string<date>
required

ISO date, YYYY-MM-DD.

external_patient_id
string

Your identifier for this patient. Acts as an idempotency key.

assigned_prescriber_id
string<uuid>

For clinics with their own prescribers: pin this patient to one of them (ids from GET /prescribers). Must be an active prescriber of your clinic, otherwise the request fails with validation_failed. Without it the platform picks the prescriber (see GET /prescriber-route).

gender
string
email
string<email>
phone
string
address
object
allergies
string[]
current_medications
string[]

Response

Idempotent replay — a patient with this external_patient_id already exists. The original resource is returned.

data
object
Example: