---
title: "Create Consult"
method: POST
path: "/consults/v0/consult"
tags: ["consults"]
---

# Create Consult

`POST /consults/v0/consult`

Create a new Consult

## Request body

- CreateConsult
  - `metadata` string — Customer-side identifier
  - `patient` Patient, required
    - `patient_token` string
    - `id` string
    - `first_name` string — Patient first name
    - `last_name` string, required — Patient last name
    - `gender` 'male' | 'female' | 'unknown', required — Patient gender
    - `dob` string, required — Date of birth
    - `home_zip` string, required — Patient home zip
    - `preferred_contact` 'email' | 'phone' | 'sms', required
    - `contacts` Contacts
      - `email` string
      - `phone` string — Patient’s phone number
      - `sms` string
      - `other_contacts` Model189[] — Patient’s other contacts
        - `number` string, required — other contact number
        - `type` 'mobile' | 'home' | 'power_of_attorney' | 'care_giver' | 'family_member' | 'other', required — other contact type
    - `payment` Payment
      - `customer_token` string
      - `shipping_option` string
    - `current_medications` Current20medication — unresolved $ref
    - `identification` Model191[]
      - `media_id` string — Should be a uuid
      - `form` 'SELF_PORTRAIT' | 'PHOTO_IDENTIFICATION' — The valid forms of identification required by the consult's questionnaire
  - `customer_note_to_pharmacy` string — This will be appended to the prescription note
  - `shipping_address` Shipping20address, required — unresolved $ref
  - `prescription_template` Prescription20template — unresolved $ref
  - `primary_care_provider` Primary20care20provider — unresolved $ref
  - `documents` IcdCodes
  - `insurances` string, required — Insurances information
  - `questionaire` string, required
  - `standard_questions` Standard20questions — unresolved $ref
  - `answers` Answers
    - `dischargeDate` string
    - `gapClosure` '1' | '2' | '3'
  - `preferred_treatment` PreferredTreatment
    - `rx` Model192[] — RX information
      - `id` string — Medication ID in the Questionnaire
      - `ndc` 'ANY' — National drug code
      - `days_supply` number — Days supply
      - `quantity` number — RX quantity
      - `num_refills` number — Number of refills
      - `strength` string — RX strength
      - `allow_substitutions` boolean — If medication is allowed to substitute
      - `frequency` 'MONTHLY' | 'QUARTERLY' — The frequency of medication use
      - `sig` string
      - `notes_to_pharmacist` string
    - `devices` Model193[]
      - `hcpcs` string, required
      - `quantity` number
      - `num_refills` number
    - `lab_tests` Model194[]
      - `lab_test_name` string, required
      - `days_from_now` integer, required
      - `kit_serial` string
      - `panels` string[]
      - `return_tracking_number` string
      - `return_carrier` string
  - `other_consult_info` OtherConsultInfo — Other consult information
  - `is_video_consult` boolean — If the consult is through video or not
  - `appointment` Appointment — Appointment information
    - `duration` number — Appointment duration
    - `appt_date` string, date-time, required — Appointment date
  - `payment_type` 'insurance' | 'cash' — Payment type preffered
  - `attribute` string — Additional identifier
  - `lab_tests` Lab20tests — unresolved $ref
  - `notificationSettings` NotificationSettings
    - `optOutSms` boolean
    - `optOutEmail` boolean
    - `optOutPhone` boolean
  - `media` Media
    - `videos` Model197[]
      - `id` string — Should be a uuid
    - `images` Model197[]
      - `id` string — Should be a uuid
    - `documents` Model197[]
      - `id` string — Should be a uuid
  - `authorized_representatives` Model198[]
    - `full_name` string
    - `phone` string

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/truepill/apis/truepill-api-documentation.md) · [All operations](https://skmtc.dev/truepill/apis/truepill-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truepill/truepill-api-documentation/revisions/d9aaa355c1e0/schema)