Get all marketing emails for a HubSpot account.

GET {{baseUrl}}/marketing/v3/emails/?createdAt=<dateTime>&createdAfter=<dateTime>&createdBefore=<dateTime>&updatedAt=<dateTime>&updatedAfter=<dateTime>&updatedBefore=<dateTime>&sort=<string>&sort=<string>&after=<string>&limit=<integer>&includeStats=<boolean>&type=OPTIN_EMAIL&isPublished=<boolean>&includedProperties=<string>&includedProperties=<string>&archived=<boolean>&marketingCampaignNames=<boolean>&workflowNames=<boolean>

The results can be filtered, allowing you to find a specific set of emails. See the table below for a full list of filtering options.

Request Params

KeyDatatypeRequiredDescription
createdAtstringOnly return emails created at exactly the specified time.
createdAfterstringOnly return emails created after the specified time.
createdBeforestringOnly return emails created before the specified time.
updatedAtstringOnly return emails last updated at exactly the specified time.
updatedAfterstringOnly return emails last updated after the specified time.
updatedBeforestringOnly return emails last updated before the specified time.
sortstringSpecifies which fields to use for sorting results. Valid fields are name, createdAt, updatedAt, createdBy, updatedBy. createdAt will be used by default.
sortstringSpecifies which fields to use for sorting results. Valid fields are name, createdAt, updatedAt, createdBy, updatedBy. createdAt will be used by default.
afterstringThe cursor token value to get the next set of results. You can get this from the paging.next.after JSON property of a paged response containing more results.
limitstringThe maximum number of results to return. Default is 100.
includeStatsstringInclude statistics with emails.
typestringEmail types to be filtered by. Multiple types can be included. All emails will be returned if not present.
isPublishedstringFilter by published/draft emails. All emails will be returned if not present.
includedPropertiesstring
includedPropertiesstring
archivedstringSpecifies whether to return archived emails. Defaults to false.
marketingCampaignNamesstring
workflowNamesstring

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;results&quot;:[{&quot;content&quot;:{&quot;templatePath&quot;:&quot;\u003cstring\u003e&quot;,&quot;plainTextVersion&quot;:&quot;\u003cstring\u003e&quot;,&quot;widgets&quot;:{&quot;ad_d84&quot;:{}},&quot;widgetContainers&quot;:{&quot;irure_34&quot;:{},&quot;sed_9&quot;:{},&quot;fugiat2&quot;:{},&quot;et_7c0&quot;:{},&quot;sunt_acc&quot;:{}},&quot;flexAreas&quot;:{&quot;magna726&quot;:{},&quot;sintebe&quot;:{},&quot;tempor_4a&quot;:{},&quot;occaecatf15&quot;:{}},&quot;styleSettings&quot;:{},&quot;smartFields&quot;:{&quot;adipisicing_d4&quot;:{},&quot;enim1_&quot;:{},&quot;culpac6&quot;:{}},&quot;themeSettingsValues&quot;:{&quot;elit0&quot;:{},&quot;occaecatb&quot;:{},&quot;anim_e5&quot;:{},&quot;cupidatat3&quot;:{}}},&quot;from&quot;:{&quot;fromName&quot;:&quot;\u003cstring\u003e&quot;,&quot;replyTo&quot;:&quot;\u003cstring\u003e&quot;,&quot;customReplyTo&quot;:&quot;\u003cstring\u003e&quot;},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;sendOnPublish&quot;:&quot;\u003cboolean\u003e&quot;,&quot;state&quot;:&quot;SCHEDULED_AB&quot;,&quot;subcategory&quot;:&quot;\u003cstring\u003e&quot;,&quot;subject&quot;:&quot;\u003cstring\u003e&quot;,&quot;to&quot;:{&quot;contactLists&quot;:{&quot;include&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;],&quot;exclude&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;]},&quot;contactIds&quot;:{&quot;include&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;],&quot;exclude&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;]},&quot;limitSendFrequency&quot;:&quot;\u003cboolean\u003e&quot;,&quot;suppressGraymail&quot;:&quot;\u003cboolean\u003e&quot;},&quot;createdById&quot;:&quot;\u003cinteger\u003e&quot;,&quot;type&quot;:&quot;MEMBERSHIP_REGISTRATION_EMAIL&quot;,&quot;activeDomain&quot;:&quot;\u003cstring\u003e&quot;,&quot;archived&quot;:&quot;\u003cboolean\u003e&quot;,&quot;folderId&quot;:&quot;\u003clong\u003e&quot;,&quot;feedbackSurveyId&quot;:&quot;\u003cinteger\u003e&quot;,&quot;stats&quot;:{&quot;counters&quot;:{&quot;mollit_9d7&quot;:&quot;\u003clong\u003e&quot;,&quot;utd&quot;:&quot;\u003clong\u003e&quot;,&quot;excd7&quot;:&quot;\u003clong\u003e&quot;},&quot;deviceBreakdown&quot;:{&quot;inb33&quot;:{&quot;tempor_b52&quot;:&quot;\u003clong\u003e&quot;},&quot;adb7c&quot;:{&quot;quis_0&quot;:&quot;\u003clong\u003e&quot;}},&quot;qualifierStats&quot;:{&quot;dolore47&quot;:{&quot;est7&quot;:&quot;\u003clong\u003e&quot;}},&quot;ratios&quot;:{&quot;dolord55&quot;:&quot;\u003cnumber\u003e&quot;}},&quot;testing&quot;:{&quot;testId&quot;:&quot;\u003clong\u003e&quot;,&quot;hoursToWait&quot;:&quot;\u003cinteger\u003e&quot;,&quot;abSuccessMetric&quot;:&quot;OPENS_BY_DELIVERED&quot;,&quot;abSampleSizeDefault&quot;:&quot;automated_loser_variant&quot;,&quot;abStatus&quot;:&quot;mab_variant&quot;,&quot;abTestPercentage&quot;:&quot;\u003cinteger\u003e&quot;,&quot;abSamplingDefault&quot;:&quot;automated_loser_variant&quot;},&quot;subscriptionDetails&quot;:{&quot;subscriptionId&quot;:&quot;\u003clong\u003e&quot;,&quot;preferencesGroupId&quot;:&quot;\u003clong\u003e&quot;,&quot;officeLocationId&quot;:&quot;\u003cstring\u003e&quot;},&quot;updatedById&quot;:&quot;\u003cinteger\u003e&quot;,&quot;publishedById&quot;:&quot;\u003cinteger\u003e&quot;,&quot;language&quot;:&quot;ff&quot;,&quot;campaign&quot;:&quot;\u003cstring\u003e&quot;,&quot;webversion&quot;:{&quot;slug&quot;:&quot;\u003cstring\u003e&quot;,&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metaDescription&quot;:&quot;\u003cstring\u003e&quot;,&quot;redirectToUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;redirectToPageId&quot;:&quot;\u003clong\u003e&quot;,&quot;expiresAt&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;rssData&quot;:{&quot;maxEntries&quot;:&quot;\u003cinteger\u003e&quot;,&quot;timing&quot;:{&quot;deseruntc34&quot;:{},&quot;Duis_772&quot;:{},&quot;nulla_328&quot;:{},&quot;idfd2&quot;:{}},&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;hubspotBlogId&quot;:&quot;\u003clong\u003e&quot;,&quot;blogEmailType&quot;:&quot;\u003cstring\u003e&quot;,&quot;blogImageMaxWidth&quot;:&quot;\u003cinteger\u003e&quot;,&quot;rssEntryTemplate&quot;:&quot;\u003cstring\u003e&quot;,&quot;useHeadlineAsSubject&quot;:&quot;\u003cboolean\u003e&quot;,&quot;blogLayout&quot;:&quot;\u003cstring\u003e&quot;},&quot;isTransactional&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isPublished&quot;:&quot;\u003cboolean\u003e&quot;,&quot;publishDate&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;updatedAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;createdAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;deletedAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;publishedAt&quot;:&quot;\u003cdateTime\u003e&quot;},{&quot;content&quot;:{&quot;templatePath&quot;:&quot;\u003cstring\u003e&quot;,&quot;plainTextVersion&quot;:&quot;\u003cstring\u003e&quot;,&quot;widgets&quot;:{&quot;dolore6&quot;:{},&quot;veniamcf&quot;:{}},&quot;widgetContainers&quot;:{&quot;cillumb3&quot;:{},&quot;consequat_e&quot;:{}},&quot;flexAreas&quot;:{&quot;pariaturcd6&quot;:{},&quot;sitf&quot;:{}},&quot;styleSettings&quot;:{},&quot;smartFields&quot;:{&quot;tempor_8e3&quot;:{}},&quot;themeSettingsValues&quot;:{&quot;esse_c47&quot;:{},&quot;dolore_0f&quot;:{}}},&quot;from&quot;:{&quot;fromName&quot;:&quot;\u003cstring\u003e&quot;,&quot;replyTo&quot;:&quot;\u003cstring\u003e&quot;,&quot;customReplyTo&quot;:&quot;\u003cstring\u003e&quot;},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;sendOnPublish&quot;:&quot;\u003cboolean\u003e&quot;,&quot;state&quot;:&quot;AUTOMATED_DRAFT_ABVARIANT&quot;,&quot;subcategory&quot;:&quot;\u003cstring\u003e&quot;,&quot;subject&quot;:&quot;\u003cstring\u003e&quot;,&quot;to&quot;:{&quot;contactLists&quot;:{&quot;include&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;],&quot;exclude&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;]},&quot;contactIds&quot;:{&quot;include&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;],&quot;exclude&quot;:[&quot;\u003clong\u003e&quot;,&quot;\u003clong\u003e&quot;]},&quot;limitSendFrequency&quot;:&quot;\u003cboolean\u003e&quot;,&quot;suppressGraymail&quot;:&quot;\u003cboolean\u003e&quot;},&quot;createdById&quot;:&quot;\u003cinteger\u003e&quot;,&quot;type&quot;:&quot;OPTIN_EMAIL&quot;,&quot;activeDomain&quot;:&quot;\u003cstring\u003e&quot;,&quot;archived&quot;:&quot;\u003cboolean\u003e&quot;,&quot;folderId&quot;:&quot;\u003clong\u003e&quot;,&quot;feedbackSurveyId&quot;:&quot;\u003cinteger\u003e&quot;,&quot;stats&quot;:{&quot;counters&quot;:{&quot;magna8&quot;:&quot;\u003clong\u003e&quot;},&quot;deviceBreakdown&quot;:{&quot;nona0d&quot;:{&quot;culpa6f2&quot;:&quot;\u003clong\u003e&quot;},&quot;ea_11&quot;:{&quot;velit8b&quot;:&quot;\u003clong\u003e&quot;,&quot;aute___&quot;:&quot;\u003clong\u003e&quot;}},&quot;qualifierStats&quot;:{&quot;et634&quot;:{&quot;sedec&quot;:&quot;\u003clong\u003e&quot;}},&quot;ratios&quot;:{&quot;dolor_0a&quot;:&quot;\u003cnumber\u003e&quot;,&quot;amet_a2&quot;:&quot;\u003cnumber\u003e&quot;,&quot;enime&quot;:&quot;\u003cnumber\u003e&quot;}},&quot;testing&quot;:{&quot;testId&quot;:&quot;\u003clong\u003e&quot;,&quot;hoursToWait&quot;:&quot;\u003cinteger\u003e&quot;,&quot;abSuccessMetric&quot;:&quot;CLICKS_BY_DELIVERED&quot;,&quot;abSampleSizeDefault&quot;:&quot;mab_master&quot;,&quot;abStatus&quot;:&quot;automated_variant&quot;,&quot;abTestPercentage&quot;:&quot;\u003cinteger\u003e&quot;,&quot;abSamplingDefault&quot;:&quot;loser_variant&quot;},&quot;subscriptionDetails&quot;:{&quot;subscriptionId&quot;:&quot;\u003clong\u003e&quot;,&quot;preferencesGroupId&quot;:&quot;\u003clong\u003e&quot;,&quot;officeLocationId&quot;:&quot;\u003cstring\u003e&quot;},&quot;updatedById&quot;:&quot;\u003cinteger\u003e&quot;,&quot;publishedById&quot;:&quot;\u003cinteger\u003e&quot;,&quot;language&quot;:&quot;sq-mk&quot;,&quot;campaign&quot;:&quot;\u003cstring\u003e&quot;,&quot;webversion&quot;:{&quot;slug&quot;:&quot;\u003cstring\u003e&quot;,&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metaDescription&quot;:&quot;\u003cstring\u003e&quot;,&quot;redirectToUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;redirectToPageId&quot;:&quot;\u003clong\u003e&quot;,&quot;expiresAt&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;rssData&quot;:{&quot;maxEntries&quot;:&quot;\u003cinteger\u003e&quot;,&quot;timing&quot;:{&quot;dolore_e_&quot;:{}},&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;hubspotBlogId&quot;:&quot;\u003clong\u003e&quot;,&quot;blogEmailType&quot;:&quot;\u003cstring\u003e&quot;,&quot;blogImageMaxWidth&quot;:&quot;\u003cinteger\u003e&quot;,&quot;rssEntryTemplate&quot;:&quot;\u003cstring\u003e&quot;,&quot;useHeadlineAsSubject&quot;:&quot;\u003cboolean\u003e&quot;,&quot;blogLayout&quot;:&quot;\u003cstring\u003e&quot;},&quot;isTransactional&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isPublished&quot;:&quot;\u003cboolean\u003e&quot;,&quot;publishDate&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;updatedAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;createdAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;deletedAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;publishedAt&quot;:&quot;\u003cdateTime\u003e&quot;}],&quot;total&quot;:&quot;\u003cinteger\u003e&quot;,&quot;paging&quot;:{&quot;next&quot;:{&quot;after&quot;:&quot;\u003cstring\u003e&quot;,&quot;link&quot;:&quot;\u003cstring\u003e&quot;}}}