Get Email Content

Endpoint essentials
API key accessapi/v1/emailer_messages/get_content or Master API key
OAuth scopesemailer_messages_get_content
Credit usage0 credits
Learn more about API pricing and credits.

Use the Get Email Content endpoint to retrieve the subject line, body, and recipients of emails that your team has already sent. Provide up to 10 email message IDs in a single request, and choose whether each body is returned as plain text (the default) or as the original HTML.

This endpoint only returns emails that your team sent and that Apollo has finished sending. Drafted, scheduled, and failed emails are never returned, and neither are replies or other inbound emails. To check on an email that hasn't been sent yet, call the Check Email Send Status endpoint instead.

Any ID that doesn't match one of your team's sent emails is left out of the response instead of causing an error. This applies to unknown IDs, malformed IDs, IDs that belong to another team, and IDs for emails that aren't sent outreach emails. Because of this, always match the results back to your request using the id field, and treat a missing id as "no sent email available" rather than a failure.

Emails are returned in the same order as the ids you sent. If you provide more than 10 IDs, Apollo uses the first 10 and ignores the rest without returning an error, so send larger jobs as batches of 10 or fewer.

To find email message IDs, call the Search for Outreach Emails endpoint and identify the id value for each email.

Body Params
ids
array of strings
required

The Apollo IDs of the sent emails whose content you want to retrieve.

Include a maximum of 10 IDs per request. If you provide more than 10, Apollo uses the first 10 IDs and ignores the rest without returning an error.

To find email message IDs, call the Search for Outreach Emails endpoint and identify the id value for each email.

Example: ["66e8cc45028aed019c25d724", "66e8cc45028aed019c25d725"]

ids*
string
enum
Defaults to plain

The format used to return the body of each email.

  • plain (default): the body is returned as plain text, with the HTML tags removed.
  • html: the body is returned as the original HTML.
This value is case-sensitive. Any other value, including HTML, is treated as plain.

Example: html

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain