Skip to Content
API access is available to organizations with a signed BAA. Request API access →
API referenceAll Patient API endpoints

Patient API endpoints

All 26 Patient API endpoints an API key can call, grouped by resource. Each links to its full reference page, with parameters, errors, and code samples.

Base URL
https://api.bloomtext.com/v1

Send the key as Authorization: Bearer $BLOOMTEXT_API_KEY. The scope column is what the key needs; see Scopes. A key that reaches more than one organization names one with org_id on every call; see Organizations a key reaches. Anything under /me or /users needs OAuth, which BloomText turns on per account; an API key gets 403 with code: oauth_required. See OAuth endpoints. An account key also calls the account endpoints.

Organization

The organization an API key acts on.

MethodPathEndpointScope
GET/organizationRetrieve the organizationAny

Patients

Patient records, always found by patient ID, phone number, or MRN.

MethodPathEndpointScope
GET/patientsFind patientspatients.read
POST/patientsCreate a patientpatients.write
GET/patients/{patientId}Retrieve a patientpatients.read
PATCH/patients/{patientId}Update a patientpatients.write
DELETE/patients/{patientId}Delete a patientpatients.write

Patient imports

Bulk imports of patient records.

MethodPathEndpointScope
POST/patient-importsImport patientspatients.write
GET/patient-imports/{importId}Retrieve an importpatients.write

Patient messages

Messages with patients: send to a patient by ID or phone number, read patient messages by time range, and check delivery.

MethodPathEndpointScope
GET/patient-messagesList patient messagesmessages.read
POST/patient-messagesSend a message to a patientmessages.write
POST/messages:batchSend messages to patients in a batchmessages.write
GET/patient-messages/{messageId}Retrieve a patient messagemessages.read

Patient conversations

Conversations with patients, one per patient and clinic phone number.

MethodPathEndpointScope
GET/patient-conversationsList patient conversationsmessages.read
GET/patient-conversations/{conversationId}Retrieve a patient conversationmessages.read

Phone numbers

The clinic phone numbers messages to patients come from, and the team each belongs to.

MethodPathEndpointScope
GET/phone-numbersList phone numbersmessages.read

Campaigns

One message sent to many patients from a clinic phone number, with per-patient delivery.

MethodPathEndpointScope
GET/campaignsList campaignsmessages.read
POST/campaignsCreate a campaignmessages.write
GET/campaigns/{campaignId}Retrieve a campaignmessages.read
PATCH/campaigns/{campaignId}Update a campaignmessages.write
DELETE/campaigns/{campaignId}Delete a campaignmessages.write
GET/campaigns/{campaignId}/recipientsList campaign recipientsmessages.read
POST/campaigns/{campaignId}/recipientsAdd campaign recipientsmessages.write
POST/campaigns/{campaignId}/recipients/removeRemove campaign recipientsmessages.write
POST/campaigns/{campaignId}/startStart a campaignmessages.write
POST/campaigns/{campaignId}/pausePause a campaignmessages.write
POST/campaigns/{campaignId}/stopStop a campaignmessages.write
Last updated on