Get revisions of a marketing email

Last updated June 17, 2020

GET marketing-emails/v1/emails/:id/versions

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Required Scope:

content

Get a list of the previously saved versions of an email,  with each entry being the full state of the email at that version.
Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.		 Used to authenticate the request. Please see this page for more details about authentication.
Email ID :email_id Used in the request URL The ID of the email that you want to get the revisions for.

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example GET URL: api.hubapi.com/marketing-emails/v1/emails/7882290601/versions?hapikey=demo Example response: [ { "id": -1, "object": { "portalId": 62515, "id": 7882290601, "slug": "-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "categoryId": 2, "state": "DRAFT", "publishDate": 0, "created": 1551387535876, "updated": 1551387710374, "templatePath": "generated_layouts/7171998220.html", "name": "test email", "archived": false, "authorName": "Leif Inouye", "deletedAt": 0, "freezeDate": 1551387710374, "processingStatus": "", "previewKey": "AJHTVitA", "createdById": 1230836, "updatedById": 1230836, "domain": "", "resolvedDomain": "demo-hubapi.hs-sites.com", "isDraft": true, "subcategory": "batch", "blueprintTypeId": 0, "analyticsPageId": "7882290601", "ctas": null, "flexAreas": {}, "widgetContainers": {}, "widgets": {}, "widgetcontainers": {}, "translatedContent": {}, "errors": [], "featuredImageWidth": 0, "featuredImageHeight": 0, "featuredImageLength": 0, "upsizeFeaturedImage": false, "userPerms": [], "teamPerms": [], "absoluteUrl": "http://demo-hubapi.hs-sites.com/-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "liveDomain": "demo-hubapi.hs-sites.com", "allEmailCampaignIds": [], "retrieveOnlyStatsData": false, "vidsExcluded": [], "isGraymailSuppressionEnabled": true, "isRecipientFatigueSuppressionEnabled": null, "mailingListsIncluded": [], "mailingListsExcluded": [], "transactional": false, "emailNote": "", "dragAndDropLayoutId": "", "dragAndDropThemeId": "", "rssEmailEntryTemplateEnabled": false, "useRssHeadlineAsSubject": false, "styleSettings": null, "maxRssEntries": 5, "rssEmailByText": "By", "rssEmailClickThroughText": "Read more »", "rssEmailCommentText": "Comment »", "rssEmailUrl": "", "rssEmailImageMaxWidth": 0, "isLocalTimezoneSend": false, "abTestPercentage": 50, "abSuccessMetric": null, "createPage": false, "headerFooterModules": false, "fromName": "tester", "customReplyToEnabled": false, "customReplyTo": "", "replyTo": "tester@gmail.com", "emailBody": "{% content_attribute \"email_body\" %}{{ default_email_body }}{% end_content_attribute %}", "abHoursToWait": 4, "abSampleSizeDefault": null, "abSamplingDefault": null, "canSpamSettingsId": 555565457, "emailPublishTag": null, "messageTags": null, "emailType": "BATCH_EMAIL", "smartEmailFields": null, "blogRssSendInfo": null, "blogRssSettings": null, "emailTemplateMode": "DESIGN_MANAGER", "automatedCategory": null, "leadFlowId": null, "feedbackEmailCategory": null, "feedbackSurveyId": null, "feedbackFormId": null, "fixupHistory": null, "referencedPropertyTypes": [], "canBeEditedInEmbeddedEditor": false, "currentlyPublished": false, "attachedStylesheets": [], "authorUsername": "cinouye@hubspot.com", "css": {}, "cssText": "", "enableDomainStylesheets": false, "enableLayoutStylesheets": false, "featuredImage": "", "featuredImageAltText": "", "hasUserChanges": true, "includeDefaultCustomCss": false, "mab": false, "mabMaster": false, "mabVariant": false, "personas": [], "placementGuids": [], "publicAccessRules": [], "publicAccessRulesEnabled": false, "tweetImmediately": false, "useFeaturedImage": false, "category": 2, "contentTypeCategoryId": 2, "createdTime": 1551387535876, "publishDateLocalTime": 0, "templatePathForRender": "generated_layouts/7171998220.html", "pageTitle": "", "subject": "this is an email API test PUT request", "title": "", "label": "test email", "currentState": "DRAFT", "vidsIncluded": [], "htmlTitle": "", "metaDescription": "", "contentTypeCategory": 2, "unpublishedAt": 0, "pastMabExperimentIds": [], "authorUserId": 1230836, "authorEmail": "cinouye@hubspot.com", "allowedSlugConflict": false, "analyticsPageType": "email", "isPublished": false, "ab": false, "abVariation": false, "publishedUrl": "", "pageRedirected": false, "pageExpiryEnabled": false, "author": "cinouye@hubspot.com", "authorAt": 1551387710374, "layoutSections": {}, "url": "http://demo-hubapi.hs-sites.com/-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "meta": { "author_email": "cinouye@hubspot.com", "include_default_custom_css": false, "enable_domain_stylesheets": false, "enable_layout_stylesheets": false, "attached_stylesheets": [], "is_graymail_suppression_enabled": true, "reply_to": "tester@gmail.com", "from_name": "tester", "author_username": "cinouye@hubspot.com", "author_user_id": 1230836, "has_user_changes": true, "html_title": "", "meta_description": "", "page_expiry_enabled": false, "page_expiry_date": null, "page_expiry_redirect_id": null, "page_expiry_redirect_url": null, "is_local_timezone_send": false, "can_spam_settings_id": 555565457, "last_edit_session_id": null, "last_edit_update_id": null, "subject": "this is an email API test PUT request" } }, "updatedAt": 0, "user": { "email": "cinouye@hubspot.com", "fullName": "Leif Inouye", "id": 1230836, "username": "cinouye@hubspot.com" } }, { "id": 7876982277, "object": { "portalId": 62515, "id": 7882290601, "slug": "-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "categoryId": 2, "state": "DRAFT", "publishDate": 0, "created": 1551387535876, "updated": 1551387554877, "templatePath": "generated_layouts/7171998220.html", "name": "test email", "archived": false, "authorName": "Leif Inouye", "deletedAt": 0, "freezeDate": 1551387554877, "processingStatus": "", "previewKey": "AJHTVitA", "createdById": 1230836, "updatedById": 1230836, "domain": "", "resolvedDomain": "demo-hubapi.hs-sites.com", "isDraft": true, "subcategory": "batch", "blueprintTypeId": 0, "analyticsPageId": "7882290601", "ctas": null, "flexAreas": {}, "widgetContainers": {}, "widgets": { "hs_email_body": { "name": "hs_email_body", "id": "hs_email_body", "label": "Main Email Body", "type": "rich_text", "body": { "html": null }, "editing": { "group": "content_type", "order": 190 } } }, "widgetcontainers": {}, "translatedContent": {}, "errors": [], "featuredImageWidth": 0, "featuredImageHeight": 0, "featuredImageLength": 0, "upsizeFeaturedImage": false, "userPerms": [], "teamPerms": [], "absoluteUrl": "http://demo-hubapi.hs-sites.com/-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "liveDomain": "demo-hubapi.hs-sites.com", "allEmailCampaignIds": [], "campaignLastTouch": 0, "retrieveOnlyStatsData": false, "vidsExcluded": [], "isGraymailSuppressionEnabled": true, "isRecipientFatigueSuppressionEnabled": null, "mailingListsIncluded": [], "mailingListsExcluded": [], "transactional": false, "emailNote": "", "dragAndDropLayoutId": "", "dragAndDropThemeId": "", "rssEmailEntryTemplateEnabled": false, "useRssHeadlineAsSubject": false, "styleSettings": null, "maxRssEntries": 5, "rssEmailByText": "By", "rssEmailClickThroughText": "Read more »", "rssEmailCommentText": "Comment »", "rssEmailUrl": "", "rssEmailImageMaxWidth": 0, "isLocalTimezoneSend": false, "abTestPercentage": 50, "abSuccessMetric": null, "createPage": false, "headerFooterModules": false, "fromName": "Leif Inouye", "customReplyToEnabled": false, "customReplyTo": "", "replyTo": "cinouye@hubspot.com", "emailBody": "{% content_attribute \"email_body\" %}{{ default_email_body }}{% end_content_attribute %}", "abHoursToWait": 4, "abSampleSizeDefault": null, "abSamplingDefault": null, "canSpamSettingsId": 555565457, "emailPublishTag": null, "messageTags": null, "emailType": "BATCH_EMAIL", "smartEmailFields": null, "blogRssSendInfo": null, "blogRssSettings": null, "emailTemplateMode": "DESIGN_MANAGER", "automatedCategory": null, "leadFlowId": null, "feedbackEmailCategory": null, "feedbackSurveyId": null, "feedbackFormId": null, "fixupHistory": null, "referencedPropertyTypes": [], "canBeEditedInEmbeddedEditor": false, "currentlyPublished": false, "attachedStylesheets": [], "authorUsername": "cinouye@hubspot.com", "css": {}, "cssText": "", "enableDomainStylesheets": false, "enableLayoutStylesheets": false, "featuredImage": "", "featuredImageAltText": "", "hasUserChanges": true, "includeDefaultCustomCss": false, "mab": false, "mabMaster": false, "mabVariant": false, "personas": [], "placementGuids": [], "publicAccessRules": [], "publicAccessRulesEnabled": false, "tweetImmediately": false, "useFeaturedImage": false, "category": 2, "contentTypeCategoryId": 2, "createdTime": 1551387535876, "publishDateLocalTime": 0, "templatePathForRender": "generated_layouts/7171998220.html", "pageTitle": "", "subject": "", "title": "", "label": "test email", "currentState": "DRAFT", "vidsIncluded": [], "htmlTitle": "", "metaDescription": "", "contentTypeCategory": 2, "unpublishedAt": 0, "pastMabExperimentIds": [], "authorUserId": 1230836, "authorEmail": "cinouye@hubspot.com", "allowedSlugConflict": false, "analyticsPageType": "email", "isPublished": false, "ab": false, "abVariation": false, "publishedUrl": "", "pageRedirected": false, "pageExpiryEnabled": false, "author": "cinouye@hubspot.com", "authorAt": 1551387554877, "layoutSections": {}, "url": "http://demo-hubapi.hs-sites.com/-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "meta": { "author_email": "cinouye@hubspot.com", "include_default_custom_css": false, "enable_domain_stylesheets": false, "enable_layout_stylesheets": false, "attached_stylesheets": [], "is_graymail_suppression_enabled": true, "reply_to": "cinouye@hubspot.com", "from_name": "Leif Inouye", "author_username": "cinouye@hubspot.com", "author_user_id": 1230836, "has_user_changes": true, "html_title": "", "meta_description": "", "page_expiry_enabled": false, "page_expiry_date": null, "page_expiry_redirect_id": null, "page_expiry_redirect_url": null, "is_local_timezone_send": false, "can_spam_settings_id": 555565457, "last_edit_session_id": null, "last_edit_update_id": null } }, "updatedAt": 1551387554877, "user": { "email": "cinouye@hubspot.com", "fullName": "Leif Inouye", "id": 1230836, "username": "cinouye@hubspot.com" } }, { "id": 7876982276, "object": { "portalId": 62515, "id": 7882290601, "slug": "-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "categoryId": 2, "state": "DRAFT", "publishDate": 0, "created": 1551387535876, "updated": 1551387535876, "templatePath": "generated_layouts/7171998220.html", "name": "test email", "archived": false, "authorName": "Leif Inouye", "deletedAt": 0, "freezeDate": 1551387535876, "processingStatus": "", "previewKey": "AJHTVitA", "createdById": 1230836, "updatedById": 1230836, "domain": "", "resolvedDomain": "demo-hubapi.hs-sites.com", "isDraft": true, "subcategory": "batch", "blueprintTypeId": 0, "analyticsPageId": "7882290601", "ctas": null, "flexAreas": {}, "widgetContainers": {}, "widgets": { "hs_email_body": { "name": "hs_email_body", "id": "hs_email_body", "label": "Main Email Body", "type": "rich_text", "body": { "html": null }, "editing": { "group": "content_type", "order": 190 } } }, "widgetcontainers": {}, "translatedContent": {}, "errors": [], "featuredImageWidth": 0, "featuredImageHeight": 0, "featuredImageLength": 0, "upsizeFeaturedImage": false, "userPerms": [], "teamPerms": [], "absoluteUrl": "http://demo-hubapi.hs-sites.com/-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "liveDomain": "demo-hubapi.hs-sites.com", "allEmailCampaignIds": [], "campaignLastTouch": 0, "retrieveOnlyStatsData": false, "vidsExcluded": [], "isGraymailSuppressionEnabled": true, "isRecipientFatigueSuppressionEnabled": null, "mailingListsIncluded": [], "mailingListsExcluded": [], "transactional": false, "emailNote": "", "dragAndDropLayoutId": "", "dragAndDropThemeId": "", "rssEmailEntryTemplateEnabled": false, "useRssHeadlineAsSubject": false, "styleSettings": null, "maxRssEntries": 5, "rssEmailByText": "By", "rssEmailClickThroughText": "Read more »", "rssEmailCommentText": "Comment »", "rssEmailUrl": "", "rssEmailImageMaxWidth": 0, "isLocalTimezoneSend": false, "abTestPercentage": 50, "abSuccessMetric": null, "createPage": false, "headerFooterModules": false, "fromName": "Leif Inouye", "customReplyToEnabled": false, "customReplyTo": "", "replyTo": "cinouye@hubspot.com", "emailBody": "{% content_attribute \"email_body\" %}{{ default_email_body }}{% end_content_attribute %}", "abHoursToWait": 4, "abSampleSizeDefault": null, "abSamplingDefault": null, "canSpamSettingsId": 555565457, "emailPublishTag": null, "messageTags": null, "emailType": "BATCH_EMAIL", "smartEmailFields": null, "blogRssSendInfo": null, "blogRssSettings": null, "emailTemplateMode": "DESIGN_MANAGER", "automatedCategory": null, "leadFlowId": null, "feedbackEmailCategory": null, "feedbackSurveyId": null, "feedbackFormId": null, "fixupHistory": null, "referencedPropertyTypes": [], "canBeEditedInEmbeddedEditor": false, "currentlyPublished": false, "attachedStylesheets": [], "authorUsername": "cinouye@hubspot.com", "css": {}, "cssText": "", "enableDomainStylesheets": false, "enableLayoutStylesheets": false, "featuredImage": "", "featuredImageAltText": "", "hasUserChanges": true, "includeDefaultCustomCss": false, "mab": false, "mabMaster": false, "mabVariant": false, "personas": [], "placementGuids": [], "publicAccessRules": [], "publicAccessRulesEnabled": false, "tweetImmediately": false, "useFeaturedImage": false, "category": 2, "contentTypeCategoryId": 2, "createdTime": 1551387535876, "publishDateLocalTime": 0, "templatePathForRender": "generated_layouts/7171998220.html", "pageTitle": "", "subject": "", "title": "", "label": "test email", "currentState": "DRAFT", "vidsIncluded": [], "htmlTitle": "", "metaDescription": "", "contentTypeCategory": 2, "unpublishedAt": 0, "pastMabExperimentIds": [], "authorUserId": 1230836, "authorEmail": "cinouye@hubspot.com", "allowedSlugConflict": false, "analyticsPageType": "email", "isPublished": false, "ab": false, "abVariation": false, "publishedUrl": "", "pageRedirected": false, "pageExpiryEnabled": false, "author": "cinouye@hubspot.com", "authorAt": 1551387535876, "layoutSections": {}, "url": "http://demo-hubapi.hs-sites.com/-temporary-slug-e1b2127b-e3d8-4073-b7e1-17e3a07c77a4", "meta": { "author_email": "cinouye@hubspot.com", "include_default_custom_css": false, "enable_domain_stylesheets": false, "enable_layout_stylesheets": false, "attached_stylesheets": [], "is_graymail_suppression_enabled": true, "reply_to": "cinouye@hubspot.com", "from_name": "Leif Inouye", "author_username": "cinouye@hubspot.com", "author_user_id": 1230836, "has_user_changes": true, "html_title": "", "meta_description": "", "page_expiry_enabled": false, "page_expiry_date": null, "page_expiry_redirect_id": null, "page_expiry_redirect_url": null, "is_local_timezone_send": false, "can_spam_settings_id": 555565457, "last_edit_session_id": null, "last_edit_update_id": null } }, "updatedAt": 1551387535876, "user": { "email": "cinouye@hubspot.com", "fullName": "Leif Inouye", "id": 1230836, "username": "cinouye@hubspot.com" } } ]