Update Patient

curl --request PATCH \
  --url https://api.usecobalt.com/v1/patients/{id} \
  --header 'Content-Type: application/json' \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>' \
  --data '
{
  "address_city": "<string>",
  "address_line2": "<string>",
  "address_state": "<string>",
  "address_street": "<string>",
  "address_zip": "<string>",
  "cell_phone": "<string>",
  "dob": "2023-12-25",
  "email": "<string>",
  "first_name": "<string>",
  "insurance_name": "<string>",
  "insurance_subscriber_number": "<string>",
  "last_name": "<string>",
  "phone": "<string>",
  "referred_to_provider_id": "<string>",
  "referring_provider_first_name": "<string>",
  "referring_provider_last_name": "<string>",
  "referring_provider_id": "<string>"
}
'

import requests

url = "https://api.usecobalt.com/v1/patients/{id}"

payload = {
    "address_city": "<string>",
    "address_line2": "<string>",
    "address_state": "<string>",
    "address_street": "<string>",
    "address_zip": "<string>",
    "cell_phone": "<string>",
    "dob": "2023-12-25",
    "email": "<string>",
    "first_name": "<string>",
    "insurance_name": "<string>",
    "insurance_subscriber_number": "<string>",
    "last_name": "<string>",
    "phone": "<string>",
    "referred_to_provider_id": "<string>",
    "referring_provider_first_name": "<string>",
    "referring_provider_last_name": "<string>",
    "referring_provider_id": "<string>"
}
headers = {
    "client_id": "<api-key>",
    "client_secret": "<api-key>",
    "access_token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    client_id: '<api-key>',
    client_secret: '<api-key>',
    access_token: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    address_city: '<string>',
    address_line2: '<string>',
    address_state: '<string>',
    address_street: '<string>',
    address_zip: '<string>',
    cell_phone: '<string>',
    dob: '2023-12-25',
    email: '<string>',
    first_name: '<string>',
    insurance_name: '<string>',
    insurance_subscriber_number: '<string>',
    last_name: '<string>',
    phone: '<string>',
    referred_to_provider_id: '<string>',
    referring_provider_first_name: '<string>',
    referring_provider_last_name: '<string>',
    referring_provider_id: '<string>'
  })
};

fetch('https://api.usecobalt.com/v1/patients/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usecobalt.com/v1/patients/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'address_city' => '<string>',
    'address_line2' => '<string>',
    'address_state' => '<string>',
    'address_street' => '<string>',
    'address_zip' => '<string>',
    'cell_phone' => '<string>',
    'dob' => '2023-12-25',
    'email' => '<string>',
    'first_name' => '<string>',
    'insurance_name' => '<string>',
    'insurance_subscriber_number' => '<string>',
    'last_name' => '<string>',
    'phone' => '<string>',
    'referred_to_provider_id' => '<string>',
    'referring_provider_first_name' => '<string>',
    'referring_provider_last_name' => '<string>',
    'referring_provider_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access_token: <api-key>",
    "client_id: <api-key>",
    "client_secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usecobalt.com/v1/patients/{id}"

	payload := strings.NewReader("{\n  \"address_city\": \"<string>\",\n  \"address_line2\": \"<string>\",\n  \"address_state\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"cell_phone\": \"<string>\",\n  \"dob\": \"2023-12-25\",\n  \"email\": \"<string>\",\n  \"first_name\": \"<string>\",\n  \"insurance_name\": \"<string>\",\n  \"insurance_subscriber_number\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"referred_to_provider_id\": \"<string>\",\n  \"referring_provider_first_name\": \"<string>\",\n  \"referring_provider_last_name\": \"<string>\",\n  \"referring_provider_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("client_id", "<api-key>")
	req.Header.Add("client_secret", "<api-key>")
	req.Header.Add("access_token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.usecobalt.com/v1/patients/{id}")
  .header("client_id", "<api-key>")
  .header("client_secret", "<api-key>")
  .header("access_token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"address_city\": \"<string>\",\n  \"address_line2\": \"<string>\",\n  \"address_state\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"cell_phone\": \"<string>\",\n  \"dob\": \"2023-12-25\",\n  \"email\": \"<string>\",\n  \"first_name\": \"<string>\",\n  \"insurance_name\": \"<string>\",\n  \"insurance_subscriber_number\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"referred_to_provider_id\": \"<string>\",\n  \"referring_provider_first_name\": \"<string>\",\n  \"referring_provider_last_name\": \"<string>\",\n  \"referring_provider_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usecobalt.com/v1/patients/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"address_city\": \"<string>\",\n  \"address_line2\": \"<string>\",\n  \"address_state\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"cell_phone\": \"<string>\",\n  \"dob\": \"2023-12-25\",\n  \"email\": \"<string>\",\n  \"first_name\": \"<string>\",\n  \"insurance_name\": \"<string>\",\n  \"insurance_subscriber_number\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"referred_to_provider_id\": \"<string>\",\n  \"referring_provider_first_name\": \"<string>\",\n  \"referring_provider_last_name\": \"<string>\",\n  \"referring_provider_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>"
}

PATCH

patients

{id}

Update Patient

curl --request PATCH \
  --url https://api.usecobalt.com/v1/patients/{id} \
  --header 'Content-Type: application/json' \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>' \
  --data '
{
  "address_city": "<string>",
  "address_line2": "<string>",
  "address_state": "<string>",
  "address_street": "<string>",
  "address_zip": "<string>",
  "cell_phone": "<string>",
  "dob": "2023-12-25",
  "email": "<string>",
  "first_name": "<string>",
  "insurance_name": "<string>",
  "insurance_subscriber_number": "<string>",
  "last_name": "<string>",
  "phone": "<string>",
  "referred_to_provider_id": "<string>",
  "referring_provider_first_name": "<string>",
  "referring_provider_last_name": "<string>",
  "referring_provider_id": "<string>"
}
'

import requests

url = "https://api.usecobalt.com/v1/patients/{id}"

payload = {
    "address_city": "<string>",
    "address_line2": "<string>",
    "address_state": "<string>",
    "address_street": "<string>",
    "address_zip": "<string>",
    "cell_phone": "<string>",
    "dob": "2023-12-25",
    "email": "<string>",
    "first_name": "<string>",
    "insurance_name": "<string>",
    "insurance_subscriber_number": "<string>",
    "last_name": "<string>",
    "phone": "<string>",
    "referred_to_provider_id": "<string>",
    "referring_provider_first_name": "<string>",
    "referring_provider_last_name": "<string>",
    "referring_provider_id": "<string>"
}
headers = {
    "client_id": "<api-key>",
    "client_secret": "<api-key>",
    "access_token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    client_id: '<api-key>',
    client_secret: '<api-key>',
    access_token: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    address_city: '<string>',
    address_line2: '<string>',
    address_state: '<string>',
    address_street: '<string>',
    address_zip: '<string>',
    cell_phone: '<string>',
    dob: '2023-12-25',
    email: '<string>',
    first_name: '<string>',
    insurance_name: '<string>',
    insurance_subscriber_number: '<string>',
    last_name: '<string>',
    phone: '<string>',
    referred_to_provider_id: '<string>',
    referring_provider_first_name: '<string>',
    referring_provider_last_name: '<string>',
    referring_provider_id: '<string>'
  })
};

fetch('https://api.usecobalt.com/v1/patients/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usecobalt.com/v1/patients/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'address_city' => '<string>',
    'address_line2' => '<string>',
    'address_state' => '<string>',
    'address_street' => '<string>',
    'address_zip' => '<string>',
    'cell_phone' => '<string>',
    'dob' => '2023-12-25',
    'email' => '<string>',
    'first_name' => '<string>',
    'insurance_name' => '<string>',
    'insurance_subscriber_number' => '<string>',
    'last_name' => '<string>',
    'phone' => '<string>',
    'referred_to_provider_id' => '<string>',
    'referring_provider_first_name' => '<string>',
    'referring_provider_last_name' => '<string>',
    'referring_provider_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access_token: <api-key>",
    "client_id: <api-key>",
    "client_secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usecobalt.com/v1/patients/{id}"

	payload := strings.NewReader("{\n  \"address_city\": \"<string>\",\n  \"address_line2\": \"<string>\",\n  \"address_state\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"cell_phone\": \"<string>\",\n  \"dob\": \"2023-12-25\",\n  \"email\": \"<string>\",\n  \"first_name\": \"<string>\",\n  \"insurance_name\": \"<string>\",\n  \"insurance_subscriber_number\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"referred_to_provider_id\": \"<string>\",\n  \"referring_provider_first_name\": \"<string>\",\n  \"referring_provider_last_name\": \"<string>\",\n  \"referring_provider_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("client_id", "<api-key>")
	req.Header.Add("client_secret", "<api-key>")
	req.Header.Add("access_token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.usecobalt.com/v1/patients/{id}")
  .header("client_id", "<api-key>")
  .header("client_secret", "<api-key>")
  .header("access_token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"address_city\": \"<string>\",\n  \"address_line2\": \"<string>\",\n  \"address_state\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"cell_phone\": \"<string>\",\n  \"dob\": \"2023-12-25\",\n  \"email\": \"<string>\",\n  \"first_name\": \"<string>\",\n  \"insurance_name\": \"<string>\",\n  \"insurance_subscriber_number\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"referred_to_provider_id\": \"<string>\",\n  \"referring_provider_first_name\": \"<string>\",\n  \"referring_provider_last_name\": \"<string>\",\n  \"referring_provider_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usecobalt.com/v1/patients/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"address_city\": \"<string>\",\n  \"address_line2\": \"<string>\",\n  \"address_state\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"cell_phone\": \"<string>\",\n  \"dob\": \"2023-12-25\",\n  \"email\": \"<string>\",\n  \"first_name\": \"<string>\",\n  \"insurance_name\": \"<string>\",\n  \"insurance_subscriber_number\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"referred_to_provider_id\": \"<string>\",\n  \"referring_provider_first_name\": \"<string>\",\n  \"referring_provider_last_name\": \"<string>\",\n  \"referring_provider_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>"
}

Use the Cobalt id in the URL path. The {id} parameter should be the Cobalt patient ID returned from API responses or GET endpoints, not the MRN or EHR ID.

The update process differs based on the current status of the patient:

1. Updating Pending or Failed Patients

For patients with a status of ‘pending’ or ‘failed’, the patient does not yet exist in the EHR. You can update any attribute, and the new values will be used the next time the patient creation runs.

Parameter	Type	Required	Description
Any patient attribute	varies	No	Any attribute of the patient can be updated. All fields are optional.

2. Updating Active Patients

For patients with a status of ‘active’ (already created in the EHR), you can update the patient’s contact information, address, and provider assignments. The change is queued and applied to the EHR asynchronously; the patient’s status will move to ‘pending_update’ while the update is in flight and back to ‘active’ once the EHR write completes.

Contact & Address Fields

Parameter	Type	Required	Description
`phone`	string	No	Home phone, formatted as `222-333-4444`.
`cell_phone`	string	No	Cell phone, formatted as `222-333-4444`.
`email`	string	No	Patient email address.
`address_street`	string	No	Street address line 1.
`address_line2`	string	No	Address line 2 (apartment, suite, unit, etc.).
`address_city`	string	No	City.
`address_state`	string	No	Two-letter state code (e.g. `CA`). DC is accepted.
`address_zip`	string	No	ZIP code. Accepts 5-digit (`12345`) or ZIP+4 (`12345-6789`) formats.
`save_previous_address`	boolean	No	When `true` (default), the patient’s current address is saved as address history in the EHR before the new address is applied. Set to `false` to overwrite without preserving history. eClinicalWorks only.

Provider Fields (eClinicalWorks Only)

Parameter	Type	Required	Description
`referring_provider_first_name`	string	No	Referring provider’s first name. Must be used with `referring_provider_last_name`.
`referring_provider_last_name`	string	No	Referring provider’s last name. Must be used with `referring_provider_first_name`.
`referring_provider_id`	string	No	Cobalt referring provider UUID (from `GET /v1/referring-providers`). Looks up the provider’s name and contact info for more accurate matching.
`pcp_first_name`	string	No	PCP’s first name. Must be used with `pcp_last_name`.
`pcp_last_name`	string	No	PCP’s last name. Must be used with `pcp_first_name`.
`pcp_id`	string	No	Cobalt referring provider UUID (from `GET /v1/referring-providers`). Looks up the provider’s name and contact info for more accurate matching.
`referred_to_provider_id`	string	No	Rendering provider EHR ID — use the `ehr_id` value from `GET /v1/providers` (not the `id`).

Demographics & Contact Preference Fields (eClinicalWorks Only)

Parameter	Type	Required	Description
`language`	string	No	Patient preferred language. Must match a valid language name in your eCW instance.
`race`	string	No	Patient race. Must match a valid race name in your eCW instance.
`ethnicity`	string	No	Patient ethnicity. Must match a valid ethnicity code or display name in your eCW instance.
`voice_enabled`	boolean	No	Enables or disables voice (phone) notifications in the eCW Patient Communications settings.
`text_enabled`	boolean	No	Enables or disables text (SMS) notifications in the eCW Patient Communications settings.

Notification language. When voice_enabled or text_enabled is set, the notification language in eCW follows the patient’s language (using the new value if language is included in the same request, otherwise the patient’s current language): Spanish when language contains “spanish” (case-insensitive), otherwise English. These are the only two options eCW exposes for communication notifications.

Contact/address fields, provider fields, demographics, and contact preferences are applied independently. If one group is rejected by the EHR (for example a provider name that cannot be resolved, or a record the EHR will not let you modify), the other groups in the same request are still applied. Anything that could not be applied is returned in a failed_fields array on the patient.updated webhook, along with a human-readable message. If no fields could be applied, the request fails and a patient.update_failed webhook is sent instead. Use referring_provider_id or pcp_id instead of names when possible, as ID-based resolution is more reliable.

At least one data field must be provided.

Example Request for Updating a Pending/Failed Patient

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "phone": "555-987-6543",
    "insurance_name": "Aetna",
    "insurance_subscriber_number": "ABC987654321"
}'

Example Request for Updating an Active Patient’s Contact Info

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "phone": "555-987-6543",
    "cell_phone": "555-987-6544",
    "email": "patient@example.com"
}'

Example Request for Updating an Active Patient’s Address

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "address_street": "456 New St",
    "address_line2": "Apt 7",
    "address_city": "Austin",
    "address_state": "TX",
    "address_zip": "78701"
}'

To update the address without saving the previous address as history, pass save_previous_address: false:

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "address_street": "456 New St",
    "address_city": "Austin",
    "address_state": "TX",
    "address_zip": "78701",
    "save_previous_address": false
}'

Example Request for Updating an Active Patient’s Providers

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "referring_provider_id": "e35e82b85df58f08a9b38e06a91e9f1a",
    "pcp_id": "223ecd1b29e546ca9db6b391eb49b213",
    "referred_to_provider_id": "82749"
}'

Or using names instead of IDs:

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "referring_provider_first_name": "Jane",
    "referring_provider_last_name": "Doe",
    "pcp_first_name": "Robert",
    "pcp_last_name": "Johnson"
}'

Example Request for Updating an Active Patient’s Demographics & Contact Preferences

curl -X PATCH https://api.usecobalt.com/v1/patients/65ed04f9d25fca3876f367d9ad94e3c3 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "language": "Spanish",
    "race": "White",
    "ethnicity": "Hispanic or Latino",
    "voice_enabled": true,
    "text_enabled": true
}'

Example Response

{
    "success": true,
    "message": "Patient update queued."
}

Only include the fields you want to update in the request body. Omitted fields will remain unchanged.

Authorizations

client_id

string

header

required

client_secret

string

header

required

access_token

string

header

required

Path Parameters

string

required

The patient's ID

Body

application/json

Option 1
Option 2

Updates for pending/failed patients. Any allowed attribute can be updated; values are used the next time patient creation runs against the EHR.

address_city

string

address_line2

string

Address line 2 (apartment, suite, unit, etc.)

address_state

string

address_street

string

address_zip

string

cell_phone

string

dob

string<date>

string

Patient email address

first_name

string

insurance_name

string

insurance_sequence

enum<string>

Available options:

primary,

secondary,

tertiary

insurance_subscriber_number

string

last_name

string

phone

string

referred_to_provider_id

string

The ehr_id of the provider this patient is being referred to (rendering provider). Use the ehr_id from GET /v1/providers

referring_provider_first_name

string

First name of the referring provider

referring_provider_last_name

string

Last name of the referring provider

referring_provider_id

string

The id of a referring provider from GET /v1/referring-providers (UUID without dashes). Can be used instead of referring_provider_first_name and referring_provider_last_name. Currently only supported for eClinicalWorks.

sex

enum<string>

Available options:

male,

female,

unknown

Response

200 - application/json

Successful response

success

boolean

message

string

Get Patients Add Patient Insurance

​1. Updating Pending or Failed Patients

​2. Updating Active Patients

​Contact & Address Fields

​Provider Fields (eClinicalWorks Only)

​Demographics & Contact Preference Fields (eClinicalWorks Only)

​Example Request for Updating a Pending/Failed Patient

​Example Request for Updating an Active Patient’s Contact Info

​Example Request for Updating an Active Patient’s Address

​Example Request for Updating an Active Patient’s Providers

​Example Request for Updating an Active Patient’s Demographics & Contact Preferences

​Example Response

Authorizations

Path Parameters

Body

Response

1. Updating Pending or Failed Patients

2. Updating Active Patients

Contact & Address Fields

Provider Fields (eClinicalWorks Only)

Demographics & Contact Preference Fields (eClinicalWorks Only)

Example Request for Updating a Pending/Failed Patient

Example Request for Updating an Active Patient’s Contact Info

Example Request for Updating an Active Patient’s Address

Example Request for Updating an Active Patient’s Providers

Example Request for Updating an Active Patient’s Demographics & Contact Preferences

Example Response