Skip to main content

You can use the Marketing Emails API to programmatically create, update, and get details about marketing emails. You can also query details about the post-send statistics of a specific email or set of emails. These statistics should match what you can access in the app on the Performance page of a sent email and will be returned under the stats object in your JSON response.

The Marketing Email API cannot be used to create or retrieve data for sales emails that are created and sent via the contact record. To get details for sales emails, use the Engagements API.

To create an email, make a POST request to /marketing/v3/emails and include the following fields in the body of your request:

You can retrieve existing emails in your account individually or in batches:

  • To retrieve an individual email, make a GET request to /marketing/v3/emails/{emailId}
  • To retrieve a list of all emails, make a GET request to /marketing/v3/emails, and include any filters as query parameters in your request (e.g., add createdAfter and a date in ISO8601 format to get all emails created after a specific date).

Click the reference documentation for a full list of endpoints and the associated parameters available.