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

# Create Patient

`POST /R4/Patient`

## Request

- Base URL: `https://sandbox.particlehealth.com`
- URL: `https://sandbox.particlehealth.com/R4/Patient`
- Auth: API key in header `Authorization`

## 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

## Changes

- **2026-11-03** `b59a5413a488`: 4 info
  - added the optional property `error_code` to the response with the `400` status
  - added the optional property `error_code` to the response with the `401` status
  - added the optional property `error_code` to the response with the `406` status
  - added the optional property `error_code` to the response with the `500` status

[Operation history](https://skmtc.dev/particlehealth/apis/particle-health-api/changes/R4/Patient/post.md)

---

[API](https://skmtc.dev/particlehealth/apis/particle-health-api.md) - [All operations](https://skmtc.dev/particlehealth/apis/particle-health-api/llms.txt) - [OpenAPI document](https://skmtc.dev/particlehealth/apis/particle-health-api/revisions/b59a5413a488?raw)