---
title: "Create an Email Draft"
method: POST
path: "/emailer_messages"
tags: ["Emailer Messages"]
---

# Create an Email Draft

`POST /emailer_messages`

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 does not send the email. <br><br>To send the draft after creating it, call the <a href="https://docs.apollo.io/reference/send-email-now" target="_blank">Send Email Now endpoint</a> with the `id` returned in the response. <br><br>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 will infer the contact and recipients from the parent message. <br><br>The email is drafted from the user that owns the API key. That user must have permission to email the contact (i.e. they own the contact or its account), and the contact must not be blocked by your team's Do Not Contact (DNC) enforcement settings. <br><br>This endpoint returns the created `emailer_message` object. If the draft is linked to an outreach task, a `task` object is also returned.

## Request body

- object
  - `contact_id` string, required — The Apollo ID for the contact that will receive the email. <br><br>This is required unless you provide `in_response_to_emailer_message_id`, in which case the contact is inferred from the parent message. <br><br>To find contact IDs, call the <a href="https://docs.apollo.io/reference/search-for-contacts" target="_blank">Search for Contacts endpoint</a> and identify the `id` value for the contact. <br><br>Example: `66e34b81740c50074e3d1bd4`
  - `subject` string — The subject line of the email. <br><br>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. <br><br>Example: `<p>Hi there, I wanted to reach out about...</p>`
  - `recipients` object[] — 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). <br><br>All recipient emails must be valid, otherwise the request fails and the email is not saved.
    - `email` string — The email address of the recipient. <br><br>Example: `ava.ruiz@sumware.com`
    - `contact_id` string — The Apollo ID for the contact associated with this recipient. <br><br>Example: `66e34b81740c50074e3d1bd4`
    - `recipient_type_cd` string — The type of recipient. <ul> <li> `to` </li> <li> `cc` </li> <li> `bcc` </li> </ul>
  - `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`. <br><br>Example: `66e8cc45028aed019c25d724`
  - `emailer_template_id` string — The Apollo ID of an email template to associate with the draft. <br><br>Example: `66e8cc45028aed019c25d725`
  - `attachment_ids` string[] — The Apollo IDs of the attachments to include with the email.
  - `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. <br><br>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. <br><br>Example: `66e8cc45028aed019c25d726`

## Response `200`

200

- object
  - `emailer_message` object
    - `id` string
    - `user_id` string
    - `status` string
    - `time_zone` unknown
    - `provider_message_id` unknown
    - `to_name` string
    - `due_at` unknown
    - `completed_at` unknown
    - `emailer_touch_id` unknown
    - `emailer_campaign_id` unknown
    - `emailer_step_id` unknown
    - `failed_at` unknown
    - `failure_reason` unknown
    - `attachment_ids` unknown[]
      - unknown
    - `enable_tracking` boolean
    - `type` string
    - `contact_id` string
    - `provider_thread_id` unknown
    - `schedule_delayed_reason` unknown
    - `demoed` unknown
    - `email_account_id` string
    - `due_at_manually_changed` unknown
    - `not_sent_reason` unknown
    - `bounce` unknown
    - `spam_blocked` unknown
    - `tracking_disabled_reason` unknown
    - `created_at` string
    - `async_sending` unknown
    - `due_at_source` unknown
    - `crm_id` unknown
    - `replied` unknown
    - `needs_dynamic_assemble` unknown
    - `personalized_opener` unknown
    - `reply_class` unknown
    - `schedule_delayed_limit_reason` unknown
    - `schedule_delayed_reason_details` unknown
    - `sensitive_info_redacted` unknown
    - `account_id` string
    - `conversation_id` unknown
    - `click_tracking_enabled` boolean
    - `open_tracking_enabled` boolean
    - `ai_variables_status` unknown
    - `recipients` object[]
      - `email` string
      - `raw_name` string
      - `recipient_type_cd` string
      - `contact_id` string
      - `user_id` unknown
    - `send_from` object
      - `email` string
      - `raw_name` unknown
      - `recipient_type_cd` unknown
      - `contact_id` unknown
      - `user_id` string
    - `from_email` string
    - `to_email` string
    - `from_name` unknown
    - `bcc_emails` unknown[]
      - unknown
    - `cc_emails` unknown[]
      - unknown
    - `send_from_info` string
    - `body_text` string
    - `body_html` string
    - `body_html_loaded` boolean
    - `subject` string
    - `contact` object
      - `id` string
      - `first_name` string
      - `last_name` string
      - `name` string
      - `email` string
      - `title` string
      - `organization_name` string
      - `account_id` string
      - `owner_id` string
      - `email_status` string

## Other responses

- `401` — 401
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)