curl --request GET \
--url https://api.hubapi.com/marketing-emails/v1/emails{
"limit": 123,
"objects": [
{
"ab": true,
"abHoursToWait": 123,
"abTestPercentage": 123,
"abVariation": true,
"absoluteUrl": "<string>",
"allEmailCampaignIds": [
123
],
"analyticsPageId": "<string>",
"analyticsPageType": "<string>",
"archived": true,
"author": "<string>",
"authorAt": 123,
"authorEmail": "<string>",
"authorName": "<string>",
"authorUserId": 123,
"campaign": "<string>",
"campaignName": "<string>",
"campaignUtm": "<string>",
"canSpamSettingsId": 123,
"categoryId": 123,
"contentTypeCategory": 123,
"created": 123,
"createdById": 123,
"currentState": "<string>",
"currentlyPublished": true,
"domain": "<string>",
"emailBody": "<string>",
"emailNote": "<string>",
"emailTemplateMode": "<string>",
"emailType": "<string>",
"emailbodyPlaintext": "<string>",
"freezeDate": 123,
"fromName": "<string>",
"htmlTitle": "<string>",
"id": 123,
"isGraymailSuppressionEnabled": true,
"isLocalTimezoneeSend": true,
"isPublished": true,
"isRecipientFatigueSuppressionEnabled": true,
"lastEditSessionId": 123,
"lastEditUpdateId": 123,
"layoutSections": {},
"leadFlowId": 123,
"liveDomain": "<string>",
"mailingListsExcluded": [
123
],
"mailingListsIncluded": [
123
],
"maxRssEntries": 123,
"metaDescription": "<string>",
"name": "<string>",
"pageExpiryEnabled": true,
"pageRedirected": true,
"portalId": 123,
"previewKey": "<string>",
"processingStatus": "<string>",
"publishDate": 123,
"publishImmediately": true,
"publishedUrl": "<string>",
"replyTo": "<string>",
"resolvedDomain": "<string>",
"rssEmailByText": "<string>",
"rssEmailClickThroughText": "<string>",
"rssEmailCommentText": "<string>",
"rssEmailEntryTemplateEnabled": true,
"rssEmailImageMaxWidth": 123,
"rssEmailUrl": "<string>",
"slug": "<string>",
"smartEmailFields": {},
"state": "<string>",
"styleSettings": {},
"subcategory": "<string>",
"subject": "<string>",
"subscription": 123,
"subscriptionName": "<string>",
"teamPerms": [
"<string>"
],
"templatePath": "<string>",
"transactional": true,
"unpublishedAt": 123,
"updated": 123,
"updatedById": 123,
"url": "<string>",
"useRssHeadlineAsSubject": true,
"userPerms": [
"<string>"
],
"vidsExcluded": [
123
],
"vidsIncluded": [
123
],
"widgets": {}
}
],
"offset": 123,
"total": 123,
"totalCount": 123
}Get all marketing emails for a HubSpot account. The results can be filtered, allowing you to find a specific set of emails you’re searching for.
curl --request GET \
--url https://api.hubapi.com/marketing-emails/v1/emails{
"limit": 123,
"objects": [
{
"ab": true,
"abHoursToWait": 123,
"abTestPercentage": 123,
"abVariation": true,
"absoluteUrl": "<string>",
"allEmailCampaignIds": [
123
],
"analyticsPageId": "<string>",
"analyticsPageType": "<string>",
"archived": true,
"author": "<string>",
"authorAt": 123,
"authorEmail": "<string>",
"authorName": "<string>",
"authorUserId": 123,
"campaign": "<string>",
"campaignName": "<string>",
"campaignUtm": "<string>",
"canSpamSettingsId": 123,
"categoryId": 123,
"contentTypeCategory": 123,
"created": 123,
"createdById": 123,
"currentState": "<string>",
"currentlyPublished": true,
"domain": "<string>",
"emailBody": "<string>",
"emailNote": "<string>",
"emailTemplateMode": "<string>",
"emailType": "<string>",
"emailbodyPlaintext": "<string>",
"freezeDate": 123,
"fromName": "<string>",
"htmlTitle": "<string>",
"id": 123,
"isGraymailSuppressionEnabled": true,
"isLocalTimezoneeSend": true,
"isPublished": true,
"isRecipientFatigueSuppressionEnabled": true,
"lastEditSessionId": 123,
"lastEditUpdateId": 123,
"layoutSections": {},
"leadFlowId": 123,
"liveDomain": "<string>",
"mailingListsExcluded": [
123
],
"mailingListsIncluded": [
123
],
"maxRssEntries": 123,
"metaDescription": "<string>",
"name": "<string>",
"pageExpiryEnabled": true,
"pageRedirected": true,
"portalId": 123,
"previewKey": "<string>",
"processingStatus": "<string>",
"publishDate": 123,
"publishImmediately": true,
"publishedUrl": "<string>",
"replyTo": "<string>",
"resolvedDomain": "<string>",
"rssEmailByText": "<string>",
"rssEmailClickThroughText": "<string>",
"rssEmailCommentText": "<string>",
"rssEmailEntryTemplateEnabled": true,
"rssEmailImageMaxWidth": 123,
"rssEmailUrl": "<string>",
"slug": "<string>",
"smartEmailFields": {},
"state": "<string>",
"styleSettings": {},
"subcategory": "<string>",
"subject": "<string>",
"subscription": 123,
"subscriptionName": "<string>",
"teamPerms": [
"<string>"
],
"templatePath": "<string>",
"transactional": true,
"unpublishedAt": 123,
"updated": 123,
"updatedById": 123,
"url": "<string>",
"useRssHeadlineAsSubject": true,
"userPerms": [
"<string>"
],
"vidsExcluded": [
123
],
"vidsIncluded": [
123
],
"widgets": {}
}
],
"offset": 123,
"total": 123,
"totalCount": 123
}contentThe number of records to return in the response. Defaults to 10. Note: A hard limit of 300 records returned.
x <= 300Used to get the next page of results. Use the limit of the previous request as the offset to get the next set of results.
Return the emails ordered by a particular field value. Use a negative value to sort in descending order (e.g. orderBy=-created).
List of marketing emails
The number of records returned
Show child attributes
Whether this is an A/B test email
Hours to wait for A/B test
Percentage for A/B test
Whether this is an A/B variation
The absolute URL of the email
All email campaign IDs associated with this email
Analytics page ID
Analytics page type
Whether the email is archived
Email author
Timestamp when authored
Author's email address
Author's name
Author's user ID
Campaign ID
Campaign name
Campaign UTM parameter
CAN-SPAM settings ID
Category ID
Content type category
Creation timestamp
ID of user who created the email
Current state of the email
Whether currently published
Domain
Email body content
Email note
Email template mode
Type of email
Plain text version of email body
Freeze date timestamp
From name
HTML title
Email ID
Whether graymail suppression is enabled
Whether to send in local timezone
Whether the email is published
Whether recipient fatigue suppression is enabled
Last edit session ID
Last edit update ID
Layout sections
Lead flow ID
Live domain
Excluded mailing lists
Included mailing lists
Maximum RSS entries
Meta description
Email name
Whether page expiry is enabled
Whether page is redirected
Portal ID
Preview key
Processing status
Publish date timestamp
Whether to publish immediately
Published URL
Reply-to email address
Resolved domain
RSS email by text
RSS email click through text
RSS email comment text
Whether RSS email entry template is enabled
RSS email image max width
RSS email URL
Email slug
Smart email fields
Email state
Style settings
Email subcategory
Email subject
Subscription ID
Subscription name
Team permissions
Template path
Whether this is a transactional email
Unpublished timestamp
Last updated timestamp
ID of user who last updated the email
Email URL
Whether to use RSS headline as subject
User permissions
Excluded video IDs
Included video IDs
Email widgets
The offset for pagination
Total number of emails
Total count of emails
Was this page helpful?