---
title: "Create Patient"
method: POST
path: "/provider/patients"
tags: ["Patient"]
---

# Create Patient

`POST /provider/patients`

## Request body

- ProviderPatientsControllerCreateBody
  - `first_name` string, required — This should be the patients legal first name.
  - `last_name` string, required — This should be the patients legal last name.
  - `middle_name` string — This should be the patients middle name.
  - `title` string
  - `suffix` string
  - `chosen_first_name` string
  - `chosen_last_name` string
  - `chosen_middle_name` string
  - `chosen_title` string
  - `chosen_suffix` string
  - `pronouns` string — May be one of `He/Him/His`, `She/Her/Hers` or `They/Them/Theirs`. Other values sent will be stored as free text.
  - `email` string
  - `sex` string — May send `male`, `female`, or `intersex`.
  - `gender` string — This field will be deprecated on March 31st 2021.
  - `gender_identity` string — May send `man`, `woman`, `trans man`, `trans woman`, `nonbinary`, or `not listed`. If you send `not listed`, please include a description in the `gender_other` field.
  - `gender_other` string — Used to specify gender identity, when not listed.
  - `dob` string, date — Date must be formatted as YYYY-MM-DD.
  - `lead_source` Association
    - `id` string, required
  - `practitioner` Association
    - `id` string, required
  - `location` Association
    - `id` string, required
  - `emergency_contact` EmergencyContact
    - `name` string
    - `email` string
    - `relationship` 'spouse' | 'parent' | 'sibling' | 'child' | 'grandparent' | 'guardian' | 'other'
    - `relationship_other` string
    - `phone` object
      - `number` number, required
      - `type` string, required
      - `us_formattable` boolean — Make this false if your number is not exactly 10 digits
  - `phones` PhoneNumber[]
    - `id` string
    - `number` number, required
    - `type` string, required
    - `us_formattable` boolean — Make this false if your number is not exactly 10 digits
  - `ssn` SocialSecurityNumber
    - `number` string
  - `health_insurance_group_id` string
  - `health_insurance_member_id` string
  - `health_insurance_payer_name` string
  - `health_insurance_payer_id` string
  - `address_line1` string
  - `address_line2` string
  - `address_city` string
  - `address_state` string
  - `address_zip` string
  - `address_country` string
  - `import_id` string — (deprecated)
  - `import_source` string — (deprecated)
  - `external_link_id` string — (deprecated)
  - `integration_record_id` string
  - `integration_error_message` string
  - `integration_web_link` string
  - `preferred_language` string — May send `en` or `es`.
  - `last_engagement_date` string, date — Date must be formatted as YYYY-MM-DD.
  - `electronic_communication_consent_accepted` boolean
  - `patient_agreement_accepted` boolean

## Response `200`

Successful response

- PublicPatientBlueprintOne
  - `id` string
  - `address_city` string
  - `address_country` string
  - `address_line1` string
  - `address_line2` string
  - `address_state` string
  - `address_zip` string
  - `age` string
  - `chosen_first_name` string
  - `chosen_last_name` string
  - `chosen_middle_name` string
  - `chosen_suffix` string
  - `chosen_title` string
  - `created_at` string, date-time
  - `dob` string, date
  - `electronic_communication_consent_accepted` string
  - `electronic_communication_consent_accepted_at` string
  - `email` string
  - `engaged` boolean
  - `external_link_id` string
  - `first_name` string
  - `gender` string
  - `gender_identity` string
  - `gender_other` string
  - `health_insurance_group_id` string
  - `health_insurance_member_id` string
  - `health_insurance_payer_id` string
  - `health_insurance_payer_name` string
  - `hipaa_authorization_accepted` boolean
  - `hipaa_authorization_accepted_at` string, date-time
  - `import_id` string
  - `import_source` string
  - `joined_practice_date` string, date
  - `last_engagement_date` string, date
  - `last_name` string
  - `lead_source_other` string
  - `master_record_sponsor` string
  - `membership_status` string
  - `middle_name` string
  - `name` string
  - `patient_agreement_accepted` boolean
  - `patient_agreement_accepted_at` string, date-time
  - `preferred_language` string
  - `pronouns` string
  - `provider_web_link` string
  - `sex` string
  - `suffix` string
  - `terms_accepted` boolean
  - `terms_accepted_at` string, date-time
  - `updated_at` string, date-time
  - `uses_tobacco` boolean
  - `account` PublicPatientBlueprintAccount
    - `name` string
    - `past_due_in_cents` integer
  - `company` PublicCompanyBlueprintLeaf
    - `id` string
    - `name` string
  - `emergency_contact` CommonEmergencyContactBlueprintShared
    - `id` string
    - `first_name` string
    - `last_name` string
    - `email` string
    - `name` string
    - `relationship` string
    - `relationship_other` string
    - `phone` CommonPhoneBlueprintShared
      - `number` string
      - `type` string
      - `us_formattable` string
  - `external_records` PublicExternalRecordBlueprintMin
    - `source` string
    - `external_id` string
  - `known_practice` PublicKnownPracticeBlueprintMin
    - `id` string
    - `name` string
  - `lead_source` PublicLeadSourceBlueprintOne
    - `id` string
    - `name` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `location` PublicLocationBlueprintOne
    - `id` string
    - `address_city` string
    - `address_country` string
    - `address_latitude` number, float
    - `address_line1` string
    - `address_line2` string
    - `address_longitude` number, float
    - `address_state` string
    - `address_zip` string
    - `distance` string
    - `name` string
    - `phone_number` string
    - `virtual` boolean
    - `location_group` PublicLocationGroupBlueprintLeaf
      - `id` string
      - `created_at` string, date-time
      - `integration_record_id` string
      - `name` string
      - `updated_at` string, date-time
  - `location_group` PublicLocationGroupBlueprintLeaf
    - `id` string
    - `created_at` string, date-time
    - `integration_record_id` string
    - `name` string
    - `updated_at` string, date-time
  - `membership_members` PublicMembershipMemberBlueprintForPatient
    - `id` string
    - `enrollment_status` string
    - `member_type` string
    - `status` string
    - `enrollment_requested_on` string, date
    - `start_date` string, date
    - `end_date` string
    - `membership` PublicMembershipBlueprintMin
      - `id` string
  - `memberships` PublicMembershipPatientBlueprintOne
    - `end_date` string
    - `enrollment_requested_on` string, date
    - `enrollment_status` string
    - `member_type` string
    - `start_date` string, date
    - `status` string
    - `uses_tobacco` boolean
    - `company` PublicCompanyBlueprintLeaf
      - `id` string
      - `name` string
    - `division` PublicEmployeeDivisionBlueprintLeaf
      - `id` string
      - `name` string
    - `payer` PublicPatientBlueprintMin
      - `id` string
      - `name` string
    - `plan` PublicPlanBlueprintMin
      - `id` string
      - `name` string
      - `plan_type` string
  - `merged_into` PublicPatientBlueprintMin
    - `id` string
    - `name` string
  - `phones` PublicPhoneBlueprintLeaf
    - `number` string
    - `type` string
  - `practitioner` PublicPractitionerBlueprintOne
    - `id` string
    - `accepts_enrollments_from_employer` string
    - `accepts_enrollments_from_retail` string
    - `bio` string
    - `created_at` string, date-time
    - `education` string
    - `email` string
    - `gender` string
    - `gender_other` string
    - `integration_record_id` string
    - `max_patient_age` string
    - `min_patient_age` string
    - `name` string
    - `online_signup_visibility` string
    - `panel_size` integer
    - `panel_size_limit` integer
    - `photo_url` string
    - `updated_at` string, date-time
    - `locations` PublicLocationBlueprintOne[]
      - `id` string
      - `address_city` string
      - `address_country` string
      - `address_latitude` number, float
      - `address_line1` string
      - `address_line2` string
      - `address_longitude` number, float
      - `address_state` string
      - `address_zip` string
      - `distance` string
      - `name` string
      - `phone_number` string
      - `virtual` boolean
      - `location_group` PublicLocationGroupBlueprintLeaf
        - `id` string
        - `created_at` string, date-time
        - `integration_record_id` string
        - `name` string
        - `updated_at` string, date-time
    - `npi` PublicNpiBlueprintShared
      - `first_name` string
      - `last_name` string
      - `number` string
      - `organization_name` string
      - `type` string
    - `specialties` PublicSpecialtyBlueprintAll[]
      - object[]
        - `id` string
        - `name` string
  - `practitioner_group` PublicLocationGroupBlueprintLeaf
    - `id` string
    - `created_at` string, date-time
    - `integration_record_id` string
    - `name` string
    - `updated_at` string, date-time
  - `sponsorships` PublicCompanySponsorshipBlueprintForPatient
    - `id` string
    - `external_id` string
    - `is_subscriber` boolean
    - `type` string
    - `company` PublicCompanyBlueprintLeaf
      - `id` string
      - `name` string
    - `family` PublicCompanyAccountBlueprintMin
      - `id` string
  - `ssn` CommonSocialSecurityNumberBlueprintMasked
    - `masked_number` string

---

[API](https://skmtc.net/hint/apis/partner-endpoints.md) · [All operations](https://skmtc.net/hint/apis/partner-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hint/partner-endpoints/versions/a92ae2a6fa90/schema)