Skip to main content
GET
/
marketing
/
v3
/
emails
cURL
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/emails \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "activeDomain": "test.hs-sites.com",
      "archived": false,
      "campaign": "1b7f51a6-33c1-44d6-ba28-fe81f655dced",
      "content": {
        "flexAreas": {
          "main": {
            "boxed": false,
            "isSingleColumnFullWidth": false,
            "sections": [
              {
                "columns": [
                  {
                    "id": "column_1606761806181_0",
                    "widgets": [
                      "module_160676180617911"
                    ],
                    "width": 12
                  }
                ],
                "id": "section_1606761806181",
                "style": {
                  "backgroundColor": "",
                  "backgroundType": "CONTENT"
                }
              },
              {
                "columns": [
                  {
                    "id": "column-0-1",
                    "widgets": [
                      "module-0-1-1"
                    ],
                    "width": 12
                  }
                ],
                "id": "section-0",
                "style": {
                  "backgroundType": "CONTENT",
                  "paddingBottom": "40px",
                  "paddingTop": "40px"
                }
              },
              {
                "columns": [
                  {
                    "id": "column-1-1",
                    "widgets": [
                      "module-1-1-1"
                    ],
                    "width": 12
                  }
                ],
                "id": "section-1",
                "style": {
                  "backgroundColor": "",
                  "backgroundType": "CONTENT",
                  "paddingBottom": "0px",
                  "paddingTop": "0px"
                }
              }
            ]
          }
        },
        "plainTextVersion": "This is custom! View in browser ({{view_as_page_url}})\n\nHello {{ contact.firstname }},\n\nPlain text emails have minimal formatting so your reader can really focus on what you have to say. Introduce yourself and explain why you’re reaching out.\n\nEvery email should try to lead the reader to some kind of action. Use this space to describe why the reader should want to click on the link below. Put the link on its own line to really draw their eye to it.\n\nLink text\n\nNow it’s time to wrap up your email. Before your signature, thank the recipient for reading. You can also invite them to send this email to any of their colleagues who might be interested.\n\nAll the best,\n\nYour full name\n\nYour job title\n\nOther contact information\n\n{{site_settings.company_name}}, {{site_settings.company_street_address_1}}, {{site_settings.company_street_address_2}}, {{site_settings.company_city}}, {{site_settings.company_state}} {{site_settings.company_zip}}, {{site_settings.company_country}}, {{site_settings.company_phone}}\n\nUnsubscribe ({{unsubscribe_link_all}})\n\nManage preferences ({{unsubscribe_link}})",
        "styleSettings": {},
        "templatePath": "@hubspot/email/dnd/plain_text.html",
        "widgets": {
          "module-0-1-1": {
            "body": {
              "css_class": "dnd-module",
              "html": "<p style=\"margin-bottom:10px;\">Hello {{ contact.firstname }},<br><br>Plain text emails have minimal formatting so your reader can really focus on what you have to say. Introduce yourself and explain why you’re reaching out.</p><p style=\"margin-bottom:10px;\">Every email should try to lead the reader to some kind of action. Use this space to describe why the reader should want to click on the link below. Put the link on its own line to really draw their eye to it.</p><p style=\"margin-bottom:10px;\"><a target=\"_blank\" rel=\"noopener\">Link text</a></p><p style=\"margin-bottom:10px;\">Now it’s time to wrap up your email. Before your signature, thank the recipient for reading. You can also invite them to send this email to any of their colleagues who might be interested.</p><p style=\"margin-bottom:10px;\">All the best,<br>Your full name<br>Your job title<br>Other contact information</p>",
              "i18nKey": "richText.plainText",
              "path": "@hubspot/rich_text",
              "schema_version": 2
            },
            "child_css": {},
            "css": {},
            "id": "module-0-1-1",
            "module_id": 1155639,
            "name": "module-0-1-1",
            "order": 2,
            "styles": {},
            "type": "module"
          },
          "module-1-1-1": {
            "body": {
              "align": "center",
              "css_class": "dnd-module",
              "font": {
                "color": "#23496d",
                "font": "Arial, sans-serif",
                "size": {
                  "units": "px",
                  "value": 12
                }
              },
              "link_font": {
                "color": "#00a4bd",
                "font": "Helvetica,Arial,sans-serif",
                "size": {
                  "units": "px",
                  "value": 12
                },
                "styles": {
                  "bold": false,
                  "italic": false,
                  "underline": true
                }
              },
              "path": "@hubspot/email_footer",
              "schema_version": 2,
              "unsubscribe_link_type": "both"
            },
            "child_css": {},
            "css": {},
            "id": "module-1-1-1",
            "module_id": 2869621,
            "name": "module-1-1-1",
            "order": 3,
            "styles": {},
            "type": "module"
          },
          "module_160676180617911": {
            "body": {
              "font": {
                "color": "#00a4bd",
                "font": "Arial, sans-serif",
                "size": {
                  "units": "px",
                  "value": 12
                },
                "styles": {
                  "bold": false,
                  "italic": false,
                  "underline": true
                }
              },
              "hs_enable_module_padding": false,
              "hs_wrapper_css": {}
            },
            "child_css": {},
            "css": {},
            "id": "module_160676180617911",
            "module_id": 2794854,
            "name": "module_160676180617911",
            "styles": {},
            "type": "module"
          },
          "preview_text": {
            "body": {
              "value": ""
            },
            "child_css": {},
            "css": {},
            "id": "preview_text",
            "label": "Preview Text <span class=help-text>This will be used as the preview text that displays in some email clients</span>",
            "name": "preview_text",
            "order": 0,
            "styles": {},
            "type": "text"
          }
        }
      },
      "createdAt": "2020-11-30T18:43:17.136Z",
      "createdById": 3739732,
      "from": {
        "fromName": "Bruce Wayne",
        "replyTo": "test@hubspot.com"
      },
      "id": "38175169118",
      "isPublished": false,
      "isTransactional": false,
      "language": "en",
      "name": "My subject",
      "publishDate": "2020-11-30T18:44:20.387Z",
      "sendOnPublish": true,
      "state": "DRAFT",
      "subcategory": "batch",
      "subject": "My subject",
      "subscriptionDetails": {
        "officeLocationId": "5449392956"
      },
      "to": {
        "contactIds": {},
        "contactIlsLists": {
          "exclude": [
            1
          ],
          "include": [
            5
          ]
        },
        "suppressGraymail": true
      },
      "type": "BATCH_EMAIL",
      "updatedAt": "2020-11-30T18:44:20.384Z",
      "updatedById": 3739732,
      "webversion": {
        "expiresAt": "2020-11-30T18:44:20.387Z",
        "metaDescription": "",
        "redirectToPageId": 0,
        "redirectToUrl": "http://www.example.org"
      }
    }
  ],
  "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

Contains information pagination of results.

Last modified on March 30, 2026