Skip to main content
POST
Create a patient

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
first_name
string
required
Example:

"Willard"

last_name
string
required
Example:

"Donnelly"

email
string
required
Example:

"Harmon43@gmail.com"

phone
string
required

10-digit phone number without formatting, e.g. 6417383445

Example:

"6417383445"

date_of_birth
string<date>
required
Example:

"1990-01-01"

address
object
required
middle_name
string
Example:

"Moises"

gender
enum<string>

Gender of the patient

Available options:
male,
female
Example:

"male"

driver_license_number
string
Example:

"B49188319"

driver_license_state
string
Example:

"CA"

ssn
string

Social Security number. Can be provided with or without hyphens.

Example:

"123456789"

primary_language
string

ISO 639-1 language code

Example:

"en"

guardian_name
string

Name of the patient's guardian. Required if patient is a minor.

Example:

"John Guardian"

guardian_phone
string
Example:

"6417383445"

guardian_email
string
Example:

"parent@example.com"

guardian_relationship
string

Relationship of the guardian to the patient. See relationship types lookup for available values; most common are parent and legal_guardian; and other can be used.

Example:

"parent"

height_inches
integer

Height of the patient in inches

Example:

72

weight_pounds
integer

Weight of the patient in pounds

Example:

180

external_id
string

External (your own) ID for the patient, to be used for prescription matching

Example:

"1234567890"

is_smoker
boolean

Whether the patient is a smoker

Example:

false

is_diabetic
boolean

Whether the patient is diabetic

Example:

false

is_pregnant
boolean

Whether the patient is pregnant

Example:

false

receive_sms
boolean

Whether the patient should receive SMS notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

receive_email
boolean

Whether the patient should receive email notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

risk_factors
object

Raw text risk factors for the patient. These will be parsed and automatically matched to standardized risk factors. Please delimit with commas, semi-colons, or slashes. Discrete risk factors can be added using the dedicated endpoints.

Response

Patient created successfully

id
string<uuid>

Unique identifier

Example:

"0227d1e5-ba9a-42b5-8fe2-38882aa65708"

created_at
string<date-time>

Date and time of creation

Example:

"2025-03-15T12:00:00Z"

updated_at
string<date-time>

Date and time of last update

Example:

"2025-03-15T12:00:00Z"

first_name
string
Example:

"Willard"

middle_name
string
Example:

"Moises"

last_name
string
Example:

"Donnelly"

gender
enum<string>

Gender of the patient

Available options:
male,
female
Example:

"male"

email
string
Example:

"Harmon43@gmail.com"

phone
string

10-digit phone number without formatting, e.g. 6417383445

Example:

"6417383445"

date_of_birth
string<date>
Example:

"1990-01-01"

driver_license_number
string
Example:

"B49188319"

driver_license_state
string
Example:

"CA"

ssn
string

Social Security number. Can be provided with or without hyphens.

Example:

"123456789"

primary_language
string

ISO 639-1 language code

Example:

"en"

guardian_name
string

Name of the patient's guardian. Required if patient is a minor.

Example:

"John Guardian"

guardian_phone
string
Example:

"6417383445"

guardian_email
string
Example:

"parent@example.com"

guardian_relationship
string

Relationship of the guardian to the patient. See relationship types lookup for available values; most common are parent and legal_guardian; and other can be used.

Example:

"parent"

height_inches
integer

Height of the patient in inches

Example:

72

weight_pounds
integer

Weight of the patient in pounds

Example:

180

external_id
string

External (your own) ID for the patient, to be used for prescription matching

Example:

"1234567890"

is_smoker
boolean

Whether the patient is a smoker

Example:

false

is_diabetic
boolean

Whether the patient is diabetic

Example:

false

is_pregnant
boolean

Whether the patient is pregnant

Example:

false

receive_sms
boolean

Whether the patient should receive SMS notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

receive_email
boolean

Whether the patient should receive email notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

address
object
is_minor
boolean

Whether the patient is a minor. Automatically calculated based on date of birth.

Example:

false