Patients

POST /patients

Creates a new patient record in the clinic.

Parameters (JSON body):

first_name (string, required)
last_name (string, required)
email (string, required)
mobile (string, required)
date_of_birth (string YYYY-MM-DD, recommended)
plus the other optional patient fields the clinic uses

Both email and mobile are required — omitting either returns 422 PATIENT_CONTACT_REQUIRED.

Request

curl -X POST https://api.vodett.ai/api/public/v1/patients \
  -H "Authorization: Bearer vodett_sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","email":"jane@example.com","mobile":"+491701234567","date_of_birth":"1990-05-14"}'

Response (201)

{
  "id": "3f9a1c22-8b0e-4c1a-9f2d-1a2b3c4d5e6f",
  "patient_number": "1001",
  "first_name": "Jane",
  "last_name": "Doe",
  "date_of_birth": "1990-05-14",
  "email": "jane@example.com",
  "mobile": "+491701234567"
}

Save the returned id — you’ll use it to book appointments and upload documents.