Skip to main content
GET
/
marketing
/
emails
/
2026-03
cURL
curl --request GET \
  --url https://api.hubapi.com/marketing/emails/2026-03 \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "isAb": true,
      "activeDomain": "<string>",
      "allEmailCampaignIds": [
        "<string>"
      ],
      "archived": true,
      "businessUnitId": "<string>",
      "campaign": "<string>",
      "campaignName": "<string>",
      "campaignUtm": "<string>",
      "clonedFrom": "<string>",
      "content": {
        "flexAreas": {},
        "plainTextVersion": "<string>",
        "smartFields": {},
        "styleSettings": {
          "backgroundColor": "<string>",
          "backgroundImage": "<string>",
          "backgroundImageType": "REPEAT",
          "bodyBorderColor": "<string>",
          "bodyBorderColorChoice": "<string>",
          "bodyBorderWidth": 123,
          "bodyColor": "<string>",
          "buttonStyleSettings": {
            "backgroundColor": {},
            "cornerRadius": 123,
            "fontStyle": {
              "bold": true,
              "color": "<string>",
              "font": "<string>",
              "italic": true,
              "size": 123,
              "underline": true
            }
          },
          "colorPickerFavorite1": "<string>",
          "colorPickerFavorite2": "<string>",
          "colorPickerFavorite3": "<string>",
          "colorPickerFavorite4": "<string>",
          "colorPickerFavorite5": "<string>",
          "colorPickerFavorite6": "<string>",
          "dividerStyleSettings": {
            "color": {},
            "height": 123,
            "lineType": "<string>"
          },
          "emailBodyPadding": "<string>",
          "emailBodyWidth": "<string>",
          "headingOneFont": {
            "bold": true,
            "color": "<string>",
            "font": "<string>",
            "italic": true,
            "size": 123,
            "underline": true
          },
          "headingTwoFont": {
            "bold": true,
            "color": "<string>",
            "font": "<string>",
            "italic": true,
            "size": 123,
            "underline": true
          },
          "linksFont": {
            "bold": true,
            "color": "<string>",
            "font": "<string>",
            "italic": true,
            "size": 123,
            "underline": true
          },
          "primaryAccentColor": "<string>",
          "primaryFont": "<string>",
          "primaryFontColor": "<string>",
          "primaryFontLineHeight": "<string>",
          "primaryFontSize": 123,
          "secondaryAccentColor": "<string>",
          "secondaryFont": "<string>",
          "secondaryFontColor": "<string>",
          "secondaryFontLineHeight": "<string>",
          "secondaryFontSize": 123
        },
        "templatePath": "<string>",
        "themeSettingsValues": {},
        "widgetContainers": {},
        "widgets": {}
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "createdById": "<string>",
      "deletedAt": "2023-11-07T05:31:56Z",
      "emailCampaignGroupId": "<string>",
      "emailTemplateMode": "DESIGN_MANAGER",
      "feedbackSurveyId": "<string>",
      "folderId": 123,
      "folderIdV2": 123,
      "from": {
        "customReplyTo": "<string>",
        "fromName": "<string>",
        "replyTo": "<string>"
      },
      "id": "<string>",
      "isPublished": true,
      "isTransactional": true,
      "jitterSendTime": true,
      "language": "aa",
      "name": "<string>",
      "previewKey": "<string>",
      "primaryEmailCampaignId": "<string>",
      "publishDate": "2023-11-07T05:31:56Z",
      "publishedAt": "2023-11-07T05:31:56Z",
      "publishedByEmail": "<string>",
      "publishedById": "<string>",
      "publishedByName": "<string>",
      "rssData": {
        "blogEmailType": "<string>",
        "blogImageMaxWidth": 123,
        "blogLayout": "FULL_POST",
        "hubspotBlogId": "<string>",
        "maxEntries": 123,
        "rssEntryTemplate": "<string>",
        "timing": {},
        "url": "<string>",
        "useHeadlineAsSubject": true
      },
      "sendOnPublish": true,
      "state": "AGENT_GENERATED",
      "stats": {
        "counters": {},
        "deviceBreakdown": {},
        "qualifierStats": {},
        "ratios": {}
      },
      "subcategory": "<string>",
      "subject": "<string>",
      "subscriptionDetails": {
        "officeLocationId": "<string>",
        "preferencesGroupId": "<string>",
        "subscriptionId": "<string>",
        "subscriptionName": "<string>"
      },
      "teamsWithAccess": [
        "<string>"
      ],
      "testing": {
        "isAbVariation": true,
        "abSampleSizeDefault": "automated_loser_variant",
        "abSamplingDefault": "automated_loser_variant",
        "abStatus": "automated_loser_variant",
        "abSuccessMetric": "CLICKS_BY_DELIVERED",
        "abTestPercentage": 123,
        "hoursToWait": 123,
        "testId": "<string>"
      },
      "to": {
        "contactIds": {
          "exclude": [
            "<string>"
          ],
          "include": [
            "<string>"
          ]
        },
        "contactIlsLists": {
          "exclude": [
            "<string>"
          ],
          "include": [
            "<string>"
          ]
        },
        "contactLists": {
          "exclude": [
            "<string>"
          ],
          "include": [
            "<string>"
          ]
        },
        "limitSendFrequency": true,
        "suppressGraymail": true
      },
      "type": "AB_EMAIL",
      "unpublishedAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "updatedById": "<string>",
      "usersWithAccess": [
        "<string>"
      ],
      "webversion": {
        "domain": "<string>",
        "enabled": true,
        "expiresAt": "2023-11-07T05:31:56Z",
        "isPageRedirected": true,
        "metaDescription": "<string>",
        "pageExpiryEnabled": true,
        "redirectToPageId": "<string>",
        "redirectToUrl": "<string>",
        "slug": "<string>",
        "title": "<string>",
        "url": "<string>"
      },
      "workflowNames": [
        "<string>"
      ]
    }
  ],
  "total": 123,
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    },
    "prev": {
      "before": "<string>",
      "link": "<string>"
    }
  }
}

Supported products

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
after
string

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

​
archived
boolean

Whether to return only results that have been archived.

​
campaign
string
​
createdAfter
string<date-time>
​
createdAt
string<date-time>
​
createdBefore
string<date-time>
​
includedProperties
string[]
​
includeStats
boolean
​
isPublished
boolean
​
limit
integer<int32>

The maximum number of results to display per page.

​
marketingCampaignNames
boolean
​
publishedAfter
string<date-time>
​
publishedAt
string<date-time>
​
publishedBefore
string<date-time>
​
sort
string[]
​
type
enum<string>
Available options:
AB_EMAIL,
AUTOMATED_AB_EMAIL,
AUTOMATED_EMAIL,
BATCH_EMAIL,
BLOG_EMAIL,
BLOG_EMAIL_CHILD,
FEEDBACK_CES_EMAIL,
FEEDBACK_CUSTOM_EMAIL,
FEEDBACK_CUSTOM_SURVEY_EMAIL,
FEEDBACK_NPS_EMAIL,
FOLLOWUP_EMAIL,
LEADFLOW_EMAIL,
LOCALTIME_EMAIL,
MANAGE_PREFERENCES_EMAIL,
MARKETING_SINGLE_SEND_API,
MEMBERSHIP_EMAIL_VERIFICATION_EMAIL,
MEMBERSHIP_FOLLOW_UP_EMAIL,
MEMBERSHIP_OTP_LOGIN_EMAIL,
MEMBERSHIP_PASSWORD_RESET_EMAIL,
MEMBERSHIP_PASSWORD_SAVED_EMAIL,
MEMBERSHIP_PASSWORDLESS_AUTH_EMAIL,
MEMBERSHIP_REGISTRATION_EMAIL,
MEMBERSHIP_REGISTRATION_FOLLOW_UP_EMAIL,
MEMBERSHIP_VERIFICATION_EMAIL,
OPTIN_EMAIL,
OPTIN_FOLLOWUP_EMAIL,
RESUBSCRIBE_EMAIL,
RSS_EMAIL,
RSS_EMAIL_CHILD,
SINGLE_SEND_API,
SMTP_TOKEN,
TICKET_EMAIL
​
updatedAfter
string<date-time>
​
updatedAt
string<date-time>
​
updatedBefore
string<date-time>
​
variantStats
boolean
​
workflowNames
boolean

Response

successful operation

​
results
object[]
required
​
total
integer<int32>
required
​
paging
object
Last modified on March 30, 2026