HUhubspot
Basic

List Emails

Changed on

Retrieve a list of marketing emails from your HubSpot account. This endpoint allows you to filter emails based on various criteria such as publication date, creation date, update date, and more. You can also control the number of results per page and include additional statistics or properties in the response.

get/marketing/emails/2026-09

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/emails/2026-09
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.email.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.email.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: content

Query parameters

afterstring

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.

archivedboolean

Whether to return only results that have been archived.

campaignstring

Filter emails by campaign name.

createdAfterstring date-time

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

createdAtstring date-time

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

createdBeforestring date-time

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

includedPropertiesstring[]

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

includeStatsboolean

Include statistics in the response. Accepts a boolean value.

isPublishedboolean

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

limitinteger

The maximum number of results to display per page.

marketingCampaignNamesboolean

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

publishedAfterstring date-time

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

publishedAtstring date-time

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

publishedBeforestring date-time

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

sortstring[]

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

type'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'

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

updatedAfterstring date-time

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

updatedAtstring date-time

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

updatedBeforestring date-time

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

variantStatsboolean

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

workflowNamesboolean

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

Response

successful operation

totalinteger required

An integer representing the total number of public emails available.

Changes

  • 2026-0963a409723776Revision changes
    • info

      the security scope marketing.email.read was added to the endpoint's security scheme oauth2

    • info

      the security scope content was removed from the endpoint's security scheme oauth2

  • 2026-09f3d5b6124704Revision changes
    • info

      the security scope marketing.email.read was added to the endpoint's security scheme oauth2

    • info

      the security scope content was removed from the endpoint's security scheme oauth2