---
title: "Patient Create"
method: POST
path: "/user/patient/create"
tags: ["provider", "user"]
---

# Patient Create

`POST /user/patient/create`

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- PatientCreate
  - `firstName` string, nullable — The user's first name.
  - `lastName` string, nullable — The user's last name.
  - `externalId` string, nullable — An identifier in your system that corresponds to this patient.
  - `email` string, nullable — The user's email address.
  - `phoneNumber` string, nullable — The user's phone number.
  - `address` string, nullable — The user's primary address.
  - `addressLineTwo` string, nullable — Additional address information.
  - `city` string, nullable — The city of the user's address.
  - `state` string, nullable — The state of the user's address.
  - `zipCode` string, nullable — The postal code of the user's address.
  - `country` string, nullable — The country of the user's address.
  - `addressValid` boolean, nullable — Whether the user's address is valid.
  - `meta` object, nullable — Any additional metadata about the user relevant to your system.
  - `primaryLocationId` string, nullable — The primary location of the patient.
  - `id` string, nullable — The unique identifier for the user.
  - `firebaseUid` string, nullable — The user's Firebase UID if available.
  - `dateOfBirth` string, date, nullable — The date of birth of the patient.
  - `type` string
  - `gender` string, nullable — The gender of the patient.
  - `patientSource` 'SELF_SCHEDULING' | 'CALL' | 'TEXT' | 'MANUALLY_CREATED' | 'UPLOADED_FROM_FILE' | 'FORM' | 'SEED_DATA' | 'DEMO' | 'EXTERNAL_INTEGRATION' | 'OTHER'
  - `onSchedulingBlacklist` boolean, nullable — Whether the patient is on the scheduling blacklist.
  - `surchargeDisabled` boolean, nullable — Whether surcharges are disabled for this patient.
  - `creditBalance` integer, nullable — Patient's credit balance in cents.
  - `preferredProviderId` string, nullable — The preferred provider ID for this patient.

## Response `200`

Successful Response

- PatientSummary
  - `id` string, required — The unique identifier for the user.
  - `firstName` string, nullable — The user's first name.
  - `lastName` string, nullable — The user's last name.
  - `phoneNumber` string, nullable — The user's phone number.
  - `email` string, nullable — The user's email address.
  - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
  - `locationId` string, nullable — The location of the user.
  - `externalId` string, nullable — The user's external identifier if available.
  - `address` string, nullable — The user's primary address.
  - `addressLineTwo` string, nullable — Additional address information.
  - `city` string, nullable — The city of the user's address.
  - `state` string, nullable — The state of the user's address.
  - `zipCode` string, nullable — The postal code of the user's address.
  - `country` string, nullable — The country of the user's address.
  - `createdDate` string, date-time, required — The date and time when the user was created.
  - `addressValid` boolean, nullable — Whether the user's address is valid.
  - `meta` object, nullable — Any additional metadata about the user relevant to your system.
  - `isArchived` boolean, nullable — Whether the user is archived.
  - `primaryLocationId` string, nullable — The primary location of the user.
  - `gender` string, nullable — The gender of the patient.
  - `dateOfBirth` string, date, nullable — The date of birth of the patient.
  - `patientMedications` string[], nullable — List of patient's self-reported medications.
  - `onSchedulingBlacklist` boolean, nullable — Whether the patient is on the scheduling blacklist.
  - `surchargeDisabled` boolean, nullable — Whether surcharges are disabled for this patient.
  - `tags` PatientTagSummary[], nullable — List of patient tags
    - `id` string, required — Unique identifier for the patient tag
    - `name` string, required — Name of the patient tag
    - `emoji` string, nullable — Emoji associated with the tag
    - `color` string, nullable — Color code for the tag (hex format)
    - `isActive` boolean, required — Whether the tag is active
    - `createdDate` string, date-time, required — Date and time when the tag was created
    - `updatedDate` string, date-time, nullable — Date and time when the tag was last updated
  - `creditBalance` integer, nullable — Patient's credit balance in cents.
  - `preferredProviderId` string, nullable — The preferred provider ID for this patient.

## Other responses

- `422` — Validation Error

---

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