v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Emailer Messages

Send Email Now

Use the Send Email Now endpoint to immediately send an existing email message. This works for emails that are currently in a drafted, scheduled, or failed state — Apollo schedules the email to be sent right away and processes it asynchronously. To first create an email draft, use the <a href="https://docs.apollo.io/reference/create-an-email-draft" target="_blank">Create an Email Draft endpoint</a> and then pass the returned id to this endpoint. The email is sent from the user that owns the API key. That user must have a linked email account on the message, must have permission to send from that email account, and must have permission to email the contact. The contact must also not be blocked by your team's Do Not Contact (DNC) enforcement settings, and the user must not have exceeded their daily sending limit. Because sending is processed asynchronously, a successful 200 response means the email has been queued for sending — not that it has been delivered. To check whether the email was delivered, poll the <a href="https://docs.apollo.io/reference/check-email-send-status" target="_blank">Check Email Send Status endpoint</a> using the message id. This endpoint returns the emailer_message object. If the message is linked to an outreach task, a task object is also returned.

post/emailer_messages/{id}/send_now

Path parameters

idstring required

The Apollo ID of the email message to send. This is the id returned when you create an email draft. Example: 66e8cc45028aed019c25d724

Request body

surfacestring

Optional. The surface within Apollo that the send is initiated from. Used for internal attribution and analytics. Example: emails

Response

200

Example response

{
  "emailer_message": {
    "id": "66e8cc45028aed019c25d724",
    "user_id": "66a3d80d4238fe02d2baaaaf",
    "status": "scheduled",
    "to_name": "Ava Ruiz",
    "due_at": "2025-02-03T15:30:00.000+00:00",
    "enable_tracking": true,
    "type": "outreach_manual_email",
    "contact_id": "66e34b81740c50074e3d1bd4",
    "email_account_id": "66e8c4567f32a501b2605004",
    "due_at_manually_changed": true,
    "due_at_source": "Email was sent using Send Now action",
    "async_sending": true,
    "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"
    }
  }
}