---
title: "Create Patient"
method: POST
path: "/R4/Patient"
tags: ["FHIR"]
---

# Create Patient

`POST /R4/Patient`

## Request body

- FhirPatient
  - `address` FhirAddress[], required — The patient's home address.
    - `city` string — The person's home city.
    - `line` string[] — The person's home street address. This should not include the person's city, state, or zip code.
    - `postalCode` string — The person's home postal code.
    - `state` string — The person's home state.
  - `birthDate` string, required — The patient's date of birth, must be of the format YYYY-MM-DD.
  - `gender` string, required — The patient's gender, must be either FEMALE or MALE.
  - `id` string — The patient's FHIR resource ID. This field will be ignored if provided in create requests and an ID will be provided in the response.
  - `identifier` FhirIdentifier[] — Information used to identify the patient provided.
    - `type` FhirCodeableConcept
      - `text` string — The type of identifier being provided, must be SSN.
    - `value` string — The identifier associated with the person.
  - `name` FhirHumanName[], required — The patient's name.
    - `family` string, required — The person's family (last) name.
    - `given` string[], required — The peron's known given (first) names.
  - `resourceType` string, required — The type of resource being provided.
  - `telecom` FhirContactPoint[] — Contact information used to identify the patient provided.
    - `system` string — The type of contact information, must be PHONE or EMAIL.
    - `value` string — The person's contact information, must be a valid phone number or email address.

## Response `201`

Created

- FhirPatient
  - `address` FhirAddress[], required — The patient's home address.
    - `city` string — The person's home city.
    - `line` string[] — The person's home street address. This should not include the person's city, state, or zip code.
    - `postalCode` string — The person's home postal code.
    - `state` string — The person's home state.
  - `birthDate` string, required — The patient's date of birth, must be of the format YYYY-MM-DD.
  - `gender` string, required — The patient's gender, must be either FEMALE or MALE.
  - `id` string — The patient's FHIR resource ID. This field will be ignored if provided in create requests and an ID will be provided in the response.
  - `identifier` FhirIdentifier[] — Information used to identify the patient provided.
    - `type` FhirCodeableConcept
      - `text` string — The type of identifier being provided, must be SSN.
    - `value` string — The identifier associated with the person.
  - `name` FhirHumanName[], required — The patient's name.
    - `family` string, required — The person's family (last) name.
    - `given` string[], required — The peron's known given (first) names.
  - `resourceType` string, required — The type of resource being provided.
  - `telecom` FhirContactPoint[] — Contact information used to identify the patient provided.
    - `system` string — The type of contact information, must be PHONE or EMAIL.
    - `value` string — The person's contact information, must be a valid phone number or email address.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `406` — Not Acceptable
- `500` — Internal Server Error

---

[API](https://skmtc.net/particlehealth/apis/particle-health-api.md) · [All operations](https://skmtc.net/particlehealth/apis/particle-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/particlehealth/particle-health-api/revisions/5aead0b7515e/schema)