POST
/
patients
curl --request POST \
  --url https://api.usecobalt.com/v1/patients \
  --header 'Content-Type: application/json' \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>' \
  --data '{
  "last_name": "<string>",
  "first_name": "<string>",
  "phone": "<string>",
  "dob": "<string>",
  "sex": "male",
  "referring_provider": "<string>",
  "insurance_name": "<string>",
  "insurance_subscriber_number": "<string>",
  "insurance_sequence": "primary",
  "responsible_party": "self"
}'
{
  "success": true,
  "message": "<string>",
  "data": {
    "mrn": "<string>"
  }
}

​
Example Request

curl -X POST https://api.usecobalt.com/v1/patients \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "last_name": "Smith",
    "first_name": "John",
    "phone": "5551234567",
    "dob": "1980-01-01",
    "sex": "male",
    "referring_provider": "Dr. Jane Doe",
    "insurance_name": "Blue Cross Blue Shield",
    "insurance_subscriber_number": "XYZ123456789",
    "insurance_sequence": "primary"
}'

​
Example Response

{
    "success": true,
    "message": "Patient processing. A webhook event will be sent upon completion.",
    "patient_id": "9988776655443322"
}

​
Example Success Webhook

{
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "object": "event",
    "created": "2023-10-01T12:34:56Z",
    "type": "patient.created",
    "data": {
        "patient_id": "9988776655443322",
        "patient_mrn": "123456"
    }
}

​
Example Failure Webhook [duplicate patient]

{
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "object": "event",
    "created": "2023-10-01T12:34:56Z",
    "type": "patient.failed",
    "data": {
        "patient_id": "9988776655443322",
        "failure_reason": "Duplicate patient found. Please use the existing patient or update the patient information using the PATCH /v1/patients/:id endpoint.",
        "existing_mrn": "123456"
    }
}

Patient creation is asynchronous. Store the returned patient_id and listen for webhooks to determine the final status.

Authorizations

​
client_id
string
header
required
​
client_secret
string
header
required
​
access_token
string
header
required

Body

application/json
​
last_name
string
​
first_name
string
​
phone
string
​
dob
string
​
sex
enum<string>
Available options:
male,
female,
unknown
​
referring_provider
string
​
insurance_name
string
​
insurance_subscriber_number
string
​
insurance_sequence
enum<string>
Available options:
primary,
secondary,
tertiary
​
responsible_party
enum<string>
Available options:
self

Response

200 - application/json
Successful response
​
success
boolean
​
message
string
​
data
object