Intake answers reference

POST /v1/intakes takes a free-form responses object, but the prescriber’s intake document is built from a fixed questionnaire. Each answer is looked up by its key (the id below). A key that isn’t on this list isn’t matched: the question shows Not answered, and your value appears only under “Additional information”. Nested objects and arrays of objects are printed as raw text, so send plain strings, numbers, booleans and arrays of strings.

The response to POST /v1/intakes includes a warnings object that tells you what didn’t match, so you can fix the mapping in testing without waiting for a document: unknown_keys, missing_required, invalid_values and complete. Warnings never block the request.

Example that matches the form

{
  "category": "async",
  "external_patient_id": "pat_123",
  "external_intake_id": "intake_123",
  "responses": {
    "treatment_need": [
      "weight_loss"
    ],
    "confirm_name": "Willie Zanders",
    "confirm_dob": "1980-05-06",
    "gender": "male",
    "phone": "(713) 555-0100",
    "email": "w@example.com",
    "current_meds": "None",
    "has_allergies": "no",
    "conditions": [
      "none"
    ],
    "nicotine": "never",
    "alcohol": "occasional",
    "activity_level": "light",
    "height": "6'4\"",
    "weight": 297,
    "treatment_reason": "Get to a healthy weight",
    "prior_use": "no",
    "attest_accurate": true,
    "attest_telehealth": true
  }
}

Sending this returns "warnings": { "complete": true, "unknown_keys": [], "missing_required": [], "invalid_values": [] }.

Which questions apply

category: "async" answers the general set (Set A).
category: "hormone" — or any intake whose treatment_need includes hormone_hrt — adds the hormone set (Set B).
Questions marked “Asked when” are required only when their condition is true.
Height is text such as 5'6"; weight is a number in pounds. Convert from metric before sending.
Gender controls which pregnancy and sex-specific questions apply. Use female, male, nonbinary or prefer_not_say.

General questions (Set A)

What do you need today?

Key	Type	Required	Allowed values	Asked when
`treatment_need`	array of values	Yes	`hormone_hrt`, `weight_loss`, `peptides`, `sexual_health`, `hair`, `sleep`, `longevity`, `other`	always
`treatment_need_other`	string	No	Free text: Tell us what you’re looking for	when the matching answer is chosen

Identity & contact

Key	Type	Required	Allowed values	Asked when
`confirm_name`	string	Yes		always
`confirm_dob`	string `YYYY-MM-DD`	Yes		always
`gender`	one value	Yes	`female`, `male`, `nonbinary`, `prefer_not_say`	always
`phone`	string	Yes		always
`email`	string	Yes		always

Medications & allergies

Key	Type	Required	Allowed values	Asked when
`current_meds`	string	Yes		always
`has_allergies`	`"yes"` or `"no"`	Yes		always
`allergy_detail`	string	No	Free text: Describe the allergy and reaction	when the matching answer is chosen

Medical history

Key	Type	Required	Allowed values	Asked when
`conditions`	array of values	Yes	`heart_disease`, `high_bp`, `stroke_clots`, `liver_disease`, `kidney_disease`, `thyroid`, `diabetes`, `stomach_gastro`, `cancer`, `seizure`, `mental_health`, `other`, `none`	always
`heart_disease_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`high_bp_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`stroke_clots_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`liver_disease_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`kidney_disease_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`thyroid_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`diabetes_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`stomach_gastro_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`cancer_detail`	string	No	Free text: Cancer type & year	when the matching answer is chosen
`seizure_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`mental_health_detail`	string	No	Free text: Tell us more about this	when the matching answer is chosen
`conditions_other`	string	No	Free text: Which condition?	when the matching answer is chosen
`surgeries`	string	No		always
`nicotine`	one value	Yes	`never`, `former`, `current`	always
`alcohol`	one value	Yes	`none`, `occasional`, `regular`	always
`activity_level`	one value	Yes	`sedentary`, `light`, `moderate`, `very_active`, `athlete`	always
`recent_a1c`	string	No	Leave blank if you don’t know it.	`treatment_need` includes `weight_loss`

Vitals & body metrics

Key	Type	Required	Allowed values	Asked when
`height`	string	Yes	Example: 5’6”	always
`weight`	number	Yes		always
`blood_pressure`	string	No		always

Pregnancy

Key	Type	Required	Allowed values	Asked when
`pregnant_or_breastfeeding`	`"yes"` or `"no"`	Yes		gender is `female`
`planning_pregnancy_6mo`	`"yes"` or `"no"`	Yes		gender is `female`

Reason for treatment

Key	Type	Required	Allowed values	Asked when
`treatment_reason`	string	Yes		`treatment_need` does not include `hormone_hrt`
`prior_use`	`"yes"` or `"no"`	Yes		always
`prior_med_name`	string	Yes		`prior_use` is `yes`
`prior_last_taken`	string `YYYY-MM-DD`	Yes		`prior_use` is `yes`
`prior_dose`	string	Yes	For example: 0.5 mg	`prior_use` is `yes`
`prior_frequency`	one value	Yes	`daily`, `weekly`, `biweekly`, `other`	`prior_use` is `yes`
`prior_frequency_other`	string	No	Free text: Tell us how often	when the matching answer is chosen
`prior_results`	string	No		`prior_use` is `yes`

Attestations

Key	Type	Required	Allowed values	Asked when
`attest_accurate`	`true`	Yes		always
`attest_telehealth`	`true`	Yes		always

Hormone questions (Set B)

Added when category is hormone.

Hormone symptoms

Key	Type	Required	Allowed values	Asked when
`hormone_symptoms`	array of values	Yes	`low_energy`, `low_libido`, `mood`, `muscle`, `weight_gain`, `sleep`, `hot_flashes`, `irregular_cycles`, `other`	always
`hormone_goals`	string	No		always

Prior hormone therapy

Key	Type	Required	Allowed values	Asked when
`prior_hormone_therapy`	`"yes"` or `"no"`	Yes		always
`prior_ht_type`	array of values	No	`test_injections`, `test_cream`, `test_pellets`, `estrogen`, `progesterone`, `hcg`, `clomiphene`, `thyroid`, `other`	`prior_hormone_therapy` is `yes`
`prior_ht_type_other`	string	No		`prior_hormone_therapy` is `yes`
`prior_ht_last_used`	string	No		`prior_hormone_therapy` is `yes`
`prior_ht_side_effects`	string	No		`prior_hormone_therapy` is `yes`
`avg_sleep_hours`	string	No		always
`used_anabolics`	`"yes"` or `"no"`	Yes		always
`anabolics_detail`	string	No	Free text: Please explain	when the matching answer is chosen

Recent lab work

Key	Type	Required	Allowed values	Asked when
`recent_labs`	`"yes"` or `"no"`	Yes		always
`labs_date`	string `YYYY-MM-DD`	No	Required if you answered yes above.	`recent_labs` is `yes`
`lab_results_notes`	string	No	Paste any values or notes from your recent labs.	always
`lab_values`	string	No	Total T, Free T, Estradiol, TSH, PSA, CBC, Lipids, A1c	always
`lab_upload`	storage path (skip)	No	Saved to your secure medical vault.	always

Risk history

Key	Type	Required	Allowed values	Asked when
`cancer_history`	array of values	Yes	`none`, `breast`, `prostate`, `ovarian`, `uterine`, `other`	always
`clot_cvd_history`	`"yes"` or `"no"`	Yes		always
`clot_cvd_detail`	string	No	Free text: Describe	when the matching answer is chosen

Male-specific

Key	Type	Required	Allowed values	Asked when
`male_prostate_history`	array of values	Yes	`prostate_cancer`, `bph`, `elevated_psa`, `difficulty_urinating`, `fertility_concerns`, `testicular_injury`, `ed`, `low_sperm`, `none`	gender is `male`
`male_trying_children`	one value	Yes	`no`, `yes`, `maybe`	gender is `male`

Female-specific

Key	Type	Required	Allowed values	Asked when
`female_pregnant`	`"yes"` or `"no"`	Yes		gender is `female`
`female_menstruating`	`"yes"` or `"no"`	Yes		gender is `female`
`female_lmp`	string `YYYY-MM-DD`	No		gender is `female`
`female_periods`	array of values	No	`regular`, `irregular`, `heavy`, `painful`, `na`	gender is `female`
`female_hysterectomy`	`"yes"` or `"no"`	Yes		gender is `female`
`female_ovaries_removed`	`"yes"` or `"no"`	Yes		gender is `female`
`female_birth_control`	`"yes"` or `"no"`	Yes		gender is `female`
`female_birth_control_type`	string	No	Free text: Birth control type	when the matching answer is chosen

Hormone-therapy attestation

Key	Type	Required	Allowed values	Asked when
`attest_hormone_telehealth`	`true`	Yes		always

Getting Started

API Reference

Webhooks

Guides

Intake answers reference

Example that matches the form

Which questions apply

General questions (Set A)

What do you need today?

Identity & contact

Medications & allergies

Medical history

Vitals & body metrics

Pregnancy

Reason for treatment

Attestations

Hormone questions (Set B)

Hormone symptoms

Prior hormone therapy

Recent lab work

Risk history

Male-specific

Female-specific

Hormone-therapy attestation

​Example that matches the form

​Which questions apply

​General questions (Set A)

​What do you need today?

​Identity & contact

​Medications & allergies

​Medical history

​Vitals & body metrics

​Pregnancy

​Reason for treatment

​Attestations

​Hormone questions (Set B)

​Hormone symptoms

​Prior hormone therapy

​Recent lab work

​Risk history

​Male-specific

​Female-specific

​Hormone-therapy attestation

Example that matches the form

Which questions apply

General questions (Set A)

What do you need today?

Identity & contact

Medications & allergies

Medical history

Vitals & body metrics

Pregnancy

Reason for treatment

Attestations

Hormone questions (Set B)

Hormone symptoms

Prior hormone therapy

Recent lab work

Risk history

Male-specific

Female-specific

Hormone-therapy attestation