Retrieve marketing emails

List Emails

curl --request GET \
  --url https://api.hubapi.com/marketing/emails/2026-03 \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.hubapi.com/marketing/emails/2026-03', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/marketing/emails/2026-03",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/marketing/emails/2026-03"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/marketing/emails/2026-03")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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>"
    }
  }
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

GET

marketing

emails

2026-03

List Emails

curl --request GET \
  --url https://api.hubapi.com/marketing/emails/2026-03 \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.hubapi.com/marketing/emails/2026-03', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/marketing/emails/2026-03",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/marketing/emails/2026-03"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/marketing/emails/2026-03")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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>"
    }
  }
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

Required Scopes

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

Filter emails by campaign name.

createdAfter

string<date-time>

Filter emails created after a specific date. Format should be date-time.

createdAt

string<date-time>

Filter emails by the exact creation date. Format should be date-time.

createdBefore

string<date-time>

Filter emails created before a specific date. Format should be date-time.

includedProperties

string[]

Specify additional properties to include in the response. Accepts an array of strings.

includeStats

boolean

Include statistics in the response. Accepts a boolean value.

isPublished

boolean

Filter emails by their published status. Accepts a boolean value.

limit

integer<int32>

The maximum number of results to display per page.

marketingCampaignNames

boolean

Include marketing campaign names in the response. Accepts a boolean value.

publishedAfter

string<date-time>

Filter emails published after a specific date. Format should be date-time.

publishedAt

string<date-time>

Filter emails by the exact publication date. Format should be date-time.

publishedBefore

string<date-time>

Filter emails published before a specific date. Format should be date-time.

sort

string[]

Specify the sorting order for the results. Accepts an array of strings.

type

enum<string>

Filter emails by type. Accepts specific email types such as AB_EMAIL, BATCH_EMAIL, etc.

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>

Filter emails updated after a specific date. Format should be date-time.

updatedAt

string<date-time>

Filter emails by the exact update date. Format should be date-time.

updatedBefore

string<date-time>

Filter emails updated before a specific date. Format should be date-time.

variantStats

boolean

Include variant statistics in the response. Accepts a boolean value.

workflowNames

boolean

Include workflow names in the response. Accepts a boolean value.

Response

successful operation

results

object[]

required

An array containing the public email objects retrieved in the current page of results.

Show child attributes

total

integer<int32>

required

An integer representing the total number of public emails available.

paging

object

Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.

Show child attributes

Last modified on October 6, 2026

Account & Settings

App Management

Authentication

Automation

CMS

Communication preferences

Conversations

CRM

Events

Files

Marketing

Scheduler

Webhooks

Webhooks journal

Retrieve marketing emails

Authorizations

Query Parameters

Response