Skip to main content
POST
/
emails
/
send
Send emails
curl --request POST \
  --url https://api.maxcare.ai/v3/emails/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Organization-Id: <x-organization-id>' \
  --data '
{
  "from": "notifications",
  "subject": "Your upcoming appointment on March 25",
  "html": "<h1>Appointment Reminder</h1><p>You have an appointment scheduled for March 25 at 10:00 AM.</p>",
  "emailType": "appointment_reminder",
  "patientIds": [
    "pat_8de030393a9e417ab2b3a8b8df183631"
  ],
  "userIds": [
    "usr_1231b6f32b4f4b8f8eeb4f7806bc45b0"
  ],
  "scheduledAt": "2026-03-25T10:00:00Z"
}
'
{
  "code": "success",
  "data": {
    "sent": [
      {
        "id": "eml_a7c3f1e28b4d4a9eb5c6d7e8f9012345",
        "recipientEmail": "jane.doe@example.com",
        "recipientType": "patient",
        "recipientId": "pat_8de030393a9e417ab2b3a8b8df183631",
        "emailType": "appointment_reminder",
        "subject": "Your upcoming appointment on March 25",
        "fromAddress": "notifications@accounts.maxcare.ai",
        "status": "sent",
        "scheduledAt": null,
        "sentAt": "2026-03-25 10:00:01.234+00",
        "deliveredAt": "2026-03-25 10:00:03.567+00",
        "openedAt": null,
        "bouncedAt": null,
        "createdAt": "2026-03-25 09:59:58.891+00"
      }
    ],
    "errors": [
      {
        "recipientId": "pat_8de030393a9e417ab2b3a8b8df183631",
        "recipientType": "patient",
        "error": "Patient has no email address on file"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.maxcare.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Marketplace API key

Headers

X-Organization-Id
string
required

Target clinic organization ID

Body

application/json
from
string
required

Email sender prefix (becomes @accounts.maxcare.ai)

Example:

"notifications"

subject
string
required

Email subject line

Example:

"Your upcoming appointment on March 25"

html
string
required

Email body as raw HTML

Example:

"<h1>Appointment Reminder</h1><p>You have an appointment scheduled for March 25 at 10:00 AM.</p>"

emailType
string
required

Email type for categorization

Example:

"appointment_reminder"

patientIds
string[]

Patient IDs to send to

Example:
["pat_8de030393a9e417ab2b3a8b8df183631"]
userIds
string[]

Staff user IDs to send to

Example:
["usr_1231b6f32b4f4b8f8eeb4f7806bc45b0"]
scheduledAt
string

Schedule send time (ISO 8601)

Example:

"2026-03-25T10:00:00Z"

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required