Create patient

This endpoint creates a new patient or returns an existing patient if return_existing_if_match is true. Responds with 201 when a new patient is created, or with 200 and the existing patient when return_existing_if_match is true and a patient with matching information already exists.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

NexHealth writes a patient to the health record system only when they book their first appointment. Until then the patient exists only in NexHealth and foreign_id is null.

That first booking creates the patient in the system on athenahealth, Cloud9, Denticon, Dentrix, Dentrix Ascend, Dentrix Enterprise, Eaglesoft, eClinicalWorks, ModMed, NextGen Office, Open Dental and OrthoTrac. Curve Hero, Dolphin and PracticeWorks cannot take a new patient from the API; book with a patient the system already has. Dentrix and Eaglesoft need gender to create the record, and NexHealth stores Female when you leave it out, so send the real one. See Testing writes, per system.

Query Params
string
required

Used to scope the request to the specified institution

int32
required

Used to scope the request to the specified location

Body Params

Create patient

provider
object
required
patient
object
required
boolean
Defaults to false

If true, return existing patient with matching information (200 OK) instead of raising an error. If false, raise an error when a patient with matching information already exists (400 Bad Request). Matching is based on date of birth, name, and phone number.

Headers
string
required
Defaults to v3.0.0

The NexHealth API version

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
ChangelogMCP serverErrorsdevelopers@nexhealth.com