Skip to main content
POST
Create an email draft

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

publicAPI.v2.all

Public API v2

Body

application/json
contactId
integer
required

ID of the contact this email draft is associated with.

Example:

12345

from
string
required

Sender email address. Must match one of the caller's own connected email accounts.

Example:

"rep@acme.com"

to
string
required

Recipient email address.

Example:

"prospect@example.com"

subject
string

Email subject line.

Example:

"Quick question about your team"

body
string

Email body content (HTML or plain text).

Example:

"Hi there, I wanted to reach out..."

cc
string

CC recipient email address(es).

Example:

"manager@example.com"

bcc
string

BCC recipient email address(es).

Example:

"archive@acme.com"

templateId
integer

ID of an email template to record on the draft. It does not fill in subject or body.

Example:

678

scheduleAt
string<date-time>

ISO-8601 timestamp at which to send the draft. The draft's status becomes SCHEDULED.

Example:

"2026-07-01T15:00:00.000Z"

Response

Email draft created

success
boolean
Example:

true

data
object