Create an Email Draft

post

https://api.apollo.io/api/v1/emailer_messages

✅
No Credit Cost
This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

Use the Create an Email Draft endpoint to create a single, unsent email message (an email draft) for a contact. The draft is created with a drafted status — this endpoint doesn't send the email.

To send the draft after creating it, call the Send Email Now endpoint with the id returned in the response.

You must provide a contact_id so Apollo knows who the email is for. Alternatively, to draft a reply within an existing email thread, provide in_response_to_emailer_message_id instead and Apollo infers the contact and recipients from the parent message.

The email is drafted from the user that owns the API key. That user must have permission to email the contact (like by owning the contact or its account), and the contact must not be blocked by any do not contact settings.

This endpoint returns the created emailer_message object. If the draft is linked to an outreach task, a task object is also returned.

Body Params

contact_id

string

required

The Apollo ID for the contact that will receive the email.

This is required unless you provide in_response_to_emailer_message_id, in which case the contact is inferred from the parent message.

To find contact IDs, call the Search for Contacts endpoint and identify the id value for the contact.

Example: 66e34b81740c50074e3d1bd4

subject

string

The subject line of the email.

Example: Quick question about your team's workflow

body_html

string

The body of the email as HTML. The content is sanitized by Apollo before it is saved.

Example: <p>Hi there, I wanted to reach out about...</p>

recipients

array of objects

The list of recipients for the email. Use this to set the to, cc, and bcc recipients. If you do not provide a to recipient, Apollo keeps the existing to recipients (if any).

All recipient emails must be valid, otherwise the request fails and the email is not saved.

recipients

in_response_to_emailer_message_id

string

The Apollo ID of an existing email message that this draft is replying to. When provided, Apollo infers the contact and builds the recipients from the parent message, so you do not need to provide contact_id.

Example: 66e8cc45028aed019c25d724

emailer_template_id

string

The Apollo ID of an email template to associate with the draft.

Example: 66e8cc45028aed019c25d725

attachment_ids

array of strings

The Apollo IDs of the attachments to include with the email.

attachment_ids

enable_tracking

boolean

Set to true to enable open and click tracking for the email. This is only applied if your team is permitted to track emails.

Example: true

outreach_task_id

string

The Apollo ID of an outreach task to associate with the draft. If a drafted email already exists for this task, Apollo links to that draft instead of creating a new one.

Example: 66e8cc45028aed019c25d726

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

✅No Credit Cost

200200

401401

422422

429429

✅
No Credit Cost