Create a patient
Authorization
BearerAuth AuthorizationBearer <token>
Medblocks API key for server-side requests.
In: header
Header Parameters
Version?string
Date-pinned API version. If omitted, Medblocks uses the version pinned on your API key.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/patients" \ -H "Version: 2026-04-25" \ -H "Content-Type: application/json" \ -d '{ "patient_id": "user_42", "email": "jane@example.com", "name": "Jane Doe", "metadata": { "plan": "premium" } }'{ "id": "user_42", "resource_type": "patient", "email": "jane@example.com", "name": "Jane Doe", "metadata": { "plan": "premium" }, "created_at": "2026-04-25T14:30:00.000Z"}{ "error": { "type": "string", "code": "string", "message": "string", "param": "string", "doc_url": "http://example.com", "request_id": "string" }}Non-2xx responses use the standard API error envelope. Log
error.code and error.request_id for support.patient_id*string
Stable patient ID from your system. Must be unique inside your organization.
Length
1 <= length <= 200email?string
Patient email for display and matching in your app.
Format
emailname?string
Patient display name.
Length
length <= 200metadata?
Additional metadata returned with the Patient.