Skip to main content
POST
/
email
/
drafts
Create Draft
curl --request POST \
  --url https://api.decodahealth.com/email/drafts \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "to": [],
  "cc": [],
  "subject": "<string>",
  "bodyHtml": "<string>",
  "bodyText": "<string>",
  "threadId": "<string>",
  "parentMessageId": "<string>"
}
'
{
  "id": "<string>",
  "threadId": "<string>",
  "subject": "<string>",
  "bodyText": "<string>",
  "bodyHtml": "<string>",
  "snippet": "<string>",
  "sentDate": "2023-11-07T05:31:56Z",
  "deliveredDate": "2023-11-07T05:31:56Z",
  "isRead": true,
  "isStarred": true,
  "isDraft": true,
  "createdDate": "2023-11-07T05:31:56Z",
  "updatedDate": "2023-11-07T05:31:56Z",
  "participants": [],
  "attachments": [],
  "openCount": 0,
  "uniqueOpenCount": 0,
  "clickCount": 0,
  "uniqueClickCount": 0,
  "firstOpenedDate": "2023-11-07T05:31:56Z",
  "lastOpenedDate": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.decodahealth.com/llms.txt

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

Headers

​
TENANT
string
required

The tenant you are making this request on behalf of

​
API-KEY
string
required

Your api key

Body

application/json

Request to create a draft email.

​
to
string[]

Recipient email addresses

​
cc
string[]

CC recipients

​
subject
string | null
​
bodyHtml
string | null
​
bodyText
string | null
​
threadId
string | null

Reply to existing thread

​
parentMessageId
string | null

Parent message for reply

Response

Successful Response

Email message in API responses.

​
id
string
required
​
threadId
string
required
​
subject
string | null
required
​
bodyText
string | null
required
​
bodyHtml
string | null
required
​
snippet
string | null
required
​
status
enum<string>
required

Status of an email message through its lifecycle.

Available options:
DRAFT,
QUEUED,
SENDING,
SENT,
DELIVERED,
RECEIVED,
FAILED,
BOUNCED,
COMPLAINED
​
direction
enum<string>
required

Direction of an email message.

Available options:
INBOUND,
OUTBOUND
​
sentDate
string<date-time> | null
required
​
deliveredDate
string<date-time> | null
required
​
isRead
boolean
required
​
isStarred
boolean
required
​
isDraft
boolean
required
​
createdDate
string<date-time>
required
​
updatedDate
string<date-time> | null
required
​
participants
EmailParticipantResponse · object[]
​
attachments
EmailAttachmentResponse · object[]
​
openCount
integer
default:0
​
uniqueOpenCount
integer
default:0
​
clickCount
integer
default:0
​
uniqueClickCount
integer
default:0
​
firstOpenedDate
string<date-time> | null
​
lastOpenedDate
string<date-time> | null