v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Emailer Messages

Create an Email Draft

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. 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. 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. 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. This endpoint returns the created emailer_message object. If the draft is linked to an outreach task, a task object is also returned.

post/emailer_messages

Request body

contact_idstring 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 <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. Example: 66e34b81740c50074e3d1bd4

subjectstring

The subject line of the email. Example: Quick question about your team's workflow

body_htmlstring

The body of the email as HTML. The content is sanitized by Apollo before it is saved. Example: Hi there, I wanted to reach out about...

in_response_to_emailer_message_idstring

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_idstring

The Apollo ID of an email template to associate with the draft. Example: 66e8cc45028aed019c25d725

attachment_idsstring[]

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

enable_trackingboolean

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_idstring

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

Response

200

Example response

{
  "emailer_message": {
    "id": "66e8cc45028aed019c25d724",
    "user_id": "66a3d80d4238fe02d2baaaaf",
    "status": "drafted",
    "to_name": "Ava Ruiz",
    "enable_tracking": true,
    "type": "outreach_manual_email",
    "contact_id": "66e34b81740c50074e3d1bd4",
    "email_account_id": "66e8c4567f32a501b2605004",
    "created_at": "2025-02-03T15:30:00.000Z",
    "account_id": "612f9d6cd26c290001d9bda0",
    "click_tracking_enabled": true,
    "open_tracking_enabled": true,
    "recipients": [
      {
        "email": "ava.ruiz@sumware.com",
        "raw_name": "Ava Ruiz",
        "recipient_type_cd": "to",
        "contact_id": "66e34b81740c50074e3d1bd4"
      }
    ],
    "send_from": {
      "email": "someemail@apollo.io",
      "user_id": "66a3d80d4238fe02d2baaaaf"
    },
    "from_email": "someemail@apollo.io",
    "to_email": "ava.ruiz@sumware.com",
    "send_from_info": "66e8c4567f32a501b2605004***someemail@apollo.io",
    "body_text": "Hi Ava, I wanted to reach out about how Apollo can help your team.",
    "body_html": "<p>Hi Ava, I wanted to reach out about how Apollo can help your team.</p>",
    "body_html_loaded": true,
    "subject": "Quick question about your team's workflow",
    "contact": {
      "id": "66e34b81740c50074e3d1bd4",
      "first_name": "Ava",
      "last_name": "Ruiz",
      "name": "Ava Ruiz",
      "email": "ava.ruiz@sumware.com",
      "title": "Founder & CEO",
      "organization_name": "Sumware Software",
      "account_id": "612f9d6cd26c290001d9bda0",
      "owner_id": "66302798d03b9601c7934ebf",
      "email_status": "verified"
    }
  }
}