--- title: "List Emails" method: GET path: "/marketing/emails/2026-09" tags: ["Basic"] --- # List Emails `GET /marketing/emails/2026-09` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/marketing/emails/2026-09` - Auth: one of: - OAuth 2 - Authorization code: `https://app.hubspot.com/oauth/authorize` - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.email.read` - OAuth 2 - Authorization code: `https://app.hubspot.com/oauth/authorize` - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.email.write` - OAuth 2 - Authorization code: `https://app.hubspot.com/oauth/authorize` - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content` 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. ## Query parameters - `after` string - `archived` boolean - `campaign` string - `createdAfter` string, date-time - `createdAt` string, date-time - `createdBefore` string, date-time - `includedProperties` string[] - `includeStats` boolean - `isPublished` boolean - `limit` integer - `marketingCampaignNames` boolean - `publishedAfter` string, date-time - `publishedAt` string, date-time - `publishedBefore` string, date-time - `sort` string[] - `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' - `updatedAfter` string, date-time - `updatedAt` string, date-time - `updatedBefore` string, date-time - `variantStats` boolean - `workflowNames` boolean ## Response `200` successful operation - CollectionResponseWithTotalPublicEmail - `paging` Paging: 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. - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response - `after` string, required: The cursor token value to get the next set of results. Use this value as query parameter (&after=...) to obtain the next page. - `link` string: The link to the next page. - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response - `before` string, required: The cursor token value to get the previous set of results. Use this value as query parameter (&before=...) to obtain the previous page. - `link` string: The link to the previous page. - `results` PublicEmail[], required: An array containing the public email objects retrieved in the current page of results. - `activeDomain` string: The active domain of the email. - `allEmailCampaignIds` string[]: List of emailCampaignIds. - `archived` boolean: Determines if the email is archived or not. - `businessUnitId` string: The ID of the business unit associated with the email. - `campaign` string: The ID of the campaign this email is associated to. - `campaignName` string: The name of the campaign. - `campaignUtm` string: The UTM parameters associated with the email's campaign. - `clonedFrom` string: The ID of the email this email was cloned from. - `content` PublicEmailContent - `flexAreas` object: An object containing flexible area configurations, where each key is an area identifier and the value is an object with area properties. - `plainTextVersion` string: A string containing the plain text version of the email content. - `smartFields` object: An object containing smart field configurations, where each key is a field identifier and the value is a SmartEmailField object. - `styleSettings` PublicEmailStyleSettings - `backgroundColor` string: The background color of the email, represented as a string. - `backgroundImage` string: The URL of the background image used in the email. - `backgroundImageType` 'REPEAT' | 'SINGLE' | 'STRETCH': The type of background image display, with valid values including 'SINGLE', 'STRETCH', and 'REPEAT'. - `bodyBorderColor` string: The color of the border around the email body. - `bodyBorderColorChoice` string: A string representing the choice of border color for the email body. - `bodyBorderWidth` number: The width of the border around the email body, represented as a number. - `bodyColor` string: The color of the email body, represented as a string. - `buttonStyleSettings` PublicButtonStyleSettings - `backgroundColor` object: An object representing the background color of the button. - `cornerRadius` integer: An integer specifying the radius of the button's corners. - `fontStyle` PublicFontStyle - `bold` boolean: A boolean indicating whether the text should be bold. - `color` string: The color of the font, represented as a string. - `font` string: The type of font to be used, represented as a string. - `italic` boolean: A boolean indicating whether the text should be italicized. - `size` integer: The size of the font, represented as an integer. - `underline` boolean: A boolean indicating whether the text should be underlined. - `colorPickerFavorite1` string: A favorite color option available in the color picker, represented as a string. - `colorPickerFavorite2` string: A favorite color option available in the color picker, represented as a string. - `colorPickerFavorite3` string: A favorite color option available in the color picker, represented as a string. - `colorPickerFavorite4` string: A favorite color option available in the color picker, represented as a string. - `colorPickerFavorite5` string: A favorite color option available in the color picker, represented as a string. - `colorPickerFavorite6` string: A favorite color option available in the color picker, represented as a string. - `dividerStyleSettings` PublicDividerStyleSettings - `color` object: An object representing the color settings of the divider. - `height` integer: An integer representing the height of the divider. - `lineType` string: A string indicating the type of line used for the divider. - `emailBodyPadding` string: The padding applied to the email body, represented as a string. - `emailBodyWidth` string: The width of the email body, represented as a string. - `headingOneFont` PublicFontStyle - `bold` boolean: A boolean indicating whether the text should be bold. - `color` string: The color of the font, represented as a string. - `font` string: The type of font to be used, represented as a string. - `italic` boolean: A boolean indicating whether the text should be italicized. - `size` integer: The size of the font, represented as an integer. - `underline` boolean: A boolean indicating whether the text should be underlined. - `headingTwoFont` PublicFontStyle - `bold` boolean: A boolean indicating whether the text should be bold. - `color` string: The color of the font, represented as a string. - `font` string: The type of font to be used, represented as a string. - `italic` boolean: A boolean indicating whether the text should be italicized. - `size` integer: The size of the font, represented as an integer. - `underline` boolean: A boolean indicating whether the text should be underlined. - `linksFont` PublicFontStyle - `bold` boolean: A boolean indicating whether the text should be bold. - `color` string: The color of the font, represented as a string. - `font` string: The type of font to be used, represented as a string. - `italic` boolean: A boolean indicating whether the text should be italicized. - `size` integer: The size of the font, represented as an integer. - `underline` boolean: A boolean indicating whether the text should be underlined. - `primaryAccentColor` string: The primary accent color used in the email. - `primaryFont` string: The primary font used in the email, represented as a string. - `primaryFontColor` string: The color of the primary font. - `primaryFontLineHeight` string: The line height of the primary font, represented as a string. - `primaryFontSize` number: The size of the primary font, represented as a number. - `secondaryAccentColor` string: The secondary accent color used in the email. - `secondaryFont` string: The secondary font used in the email, represented as a string. - `secondaryFontColor` string: The color of the secondary font. - `secondaryFontLineHeight` string: The line height of the secondary font, represented as a string. - `secondaryFontSize` number: The size of the secondary font, represented as a number. - `templatePath` string: A string representing the path to the email template used for this email. - `themeSettingsValues` object: An object containing theme settings values, where each key is a setting identifier and the value is an object with setting properties. - `widgetContainers` object: An object containing widget container configurations, where each key is a container identifier and the value is an object with container properties. - `widgets` object: An object containing widget configurations, where each key is a widget identifier and the value is an object with widget properties. - `createdAt` string, date-time: The date and time of the email's creation, in ISO8601 representation. - `createdById` string: The id of the user who created the email. - `deletedAt` string, date-time: The date and time the email was deleted at, in ISO8601 representation. - `emailCampaignGroupId` string: The ID of the email campaign group associated with the email. - `emailTemplateMode` 'DESIGN_MANAGER' | 'DRAG_AND_DROP': The mode of the email template, such as 'DESIGN_MANAGER' or 'DRAG_AND_DROP'. - `feedbackSurveyId` string: The ID of the feedback survey linked to the email. - `folderId` integer: Deprecated — this field is no longer functional. Use folderIdV2 instead. - `folderIdV2` integer: The version 2 ID of the folder where the email is stored, as a 64-bit integer. - `from` PublicEmailFromDetails - `customReplyTo` string: The reply to recipients will see. - `fromName` string: The name recipients will see. - `replyTo` string: The from address and reply to email address (if no customReplyTo defined) recipients will see. - `id` string: The email ID. - `isAb` boolean, required: A boolean indicating whether the email is part of an A/B test. - `isPublished` boolean: Returns the published status of the email. This is read only. - `isTransactional` boolean: Returns whether the email is a transactional email or not. This is read only. - `jitterSendTime` boolean: A boolean indicating whether to apply a jitter to the send time. - `language` 'aa' | 'ab' | 'ae' | 'af' | 'af-na' | 'af-za' | 'agq' | 'agq-cm' | 'ak' | 'ak-gh' | 'am' | 'am-et' | 'an' | 'ann' | 'ann-ng' | 'ar' | 'ar-001' | 'ar-ae' | 'ar-bh' | 'ar-dj' | 'ar-dz' | 'ar-eg' | 'ar-eh' | 'ar-er' | 'ar-il' | 'ar-iq' | 'ar-jo' | 'ar-km' | 'ar-kw' | 'ar-lb' | 'ar-ly' | 'ar-ma' | 'ar-mr' | 'ar-om' | 'ar-ps' | 'ar-qa' | 'ar-sa' | 'ar-sd' | 'ar-so' | 'ar-ss' | 'ar-sy' | 'ar-td' | 'ar-tn' | 'ar-ye' | 'as' | 'as-in' | 'asa' | 'asa-tz' | 'ast' | 'ast-es' | 'av' | 'ay' | 'az' | 'az-az' | 'ba' | 'bal' | 'bal-pk' | 'bas' | 'bas-cm' | 'be' | 'be-by' | 'bem' | 'bem-zm' | 'bez' | 'bez-tz' | 'bg' | 'bg-bg' | 'bgc' | 'bgc-in' | 'bho' | 'bho-in' | 'bi' | 'blo' | 'blo-bj' | 'bm' | 'bm-ml' | 'bn' | 'bn-bd' | 'bn-in' | 'bo' | 'bo-cn' | 'bo-in' | 'br' | 'br-fr' | 'brx' | 'brx-in' | 'bs' | 'bs-ba' | 'ca' | 'ca-ad' | 'ca-es' | 'ca-fr' | 'ca-it' | 'ccp' | 'ccp-bd' | 'ccp-in' | 'ce' | 'ce-ru' | 'ceb' | 'ceb-ph' | 'cgg' | 'cgg-ug' | 'ch' | 'chr' | 'chr-us' | 'ckb' | 'ckb-iq' | 'ckb-ir' | 'co' | 'cr' | 'cs' | 'cs-cz' | 'csw' | 'csw-ca' | 'cu' | 'cu-ru' | 'cv' | 'cv-ru' | 'cy' | 'cy-gb' | 'da' | 'da-dk' | 'da-gl' | 'dav' | 'dav-ke' | 'de' | 'de-at' | 'de-be' | 'de-ch' | 'de-de' | 'de-gr' | 'de-it' | 'de-li' | 'de-lu' | 'dje' | 'dje-ne' | 'doi' | 'doi-in' | 'dsb' | 'dsb-de' | 'dua' | 'dua-cm' | 'dv' | 'dyo' | 'dyo-sn' | 'dz' | 'dz-bt' | 'ebu' | 'ebu-ke' | 'ee' | 'ee-gh' | 'ee-tg' | 'el' | 'el-cy' | 'el-gr' | 'en' | 'en-001' | 'en-150' | 'en-ae' | 'en-ag' | 'en-ai' | 'en-as' | 'en-at' | 'en-au' | 'en-bb' | 'en-be' | 'en-bi' | 'en-bm' | 'en-bs' | 'en-bw' | 'en-bz' | 'en-ca' | 'en-cc' | 'en-ch' | 'en-ck' | 'en-cm' | 'en-cn' | 'en-cx' | 'en-cy' | 'en-cz' | 'en-de' | 'en-dg' | 'en-dk' | 'en-dm' | 'en-ee' | 'en-eg' | 'en-er' | 'en-es' | 'en-fi' | 'en-fj' | 'en-fk' | 'en-fm' | 'en-fr' | 'en-gb' | 'en-gd' | 'en-gg' | 'en-gh' | 'en-gi' | 'en-gm' | 'en-gs' | 'en-gu' | 'en-gy' | 'en-hk' | 'en-hu' | 'en-id' | 'en-ie' | 'en-il' | 'en-im' | 'en-in' | 'en-io' | 'en-it' | 'en-je' | 'en-jm' | 'en-ke' | 'en-ki' | 'en-kn' | 'en-ky' | 'en-lc' | 'en-lr' | 'en-ls' | 'en-lu' | 'en-mg' | 'en-mh' | 'en-mo' | 'en-mp' | 'en-ms' | 'en-mt' | 'en-mu' | 'en-mv' | 'en-mw' | 'en-mx' | 'en-my' | 'en-na' | 'en-nf' | 'en-ng' | 'en-nl' | 'en-no' | 'en-nr' | 'en-nu' | 'en-nz' | 'en-pg' | 'en-ph' | 'en-pk' | 'en-pl' | 'en-pn' | 'en-pr' | 'en-pt' | 'en-pw' | 'en-ro' | 'en-rw' | 'en-sb' | 'en-sc' | 'en-sd' | 'en-se' | 'en-sg' | 'en-sh' | 'en-si' | 'en-sk' | 'en-sl' | 'en-ss' | 'en-sx' | 'en-sz' | 'en-tc' | 'en-th' | 'en-tk' | 'en-tn' | 'en-to' | 'en-tt' | 'en-tv' | 'en-tz' | 'en-ug' | 'en-um' | 'en-us' | 'en-vc' | 'en-vg' | 'en-vi' | 'en-vn' | 'en-vu' | 'en-ws' | 'en-za' | 'en-zm' | 'en-zw' | 'eo' | 'eo-001' | 'es' | 'es-419' | 'es-ar' | 'es-bo' | 'es-br' | 'es-bz' | 'es-cl' | 'es-co' | 'es-cr' | 'es-cu' | 'es-do' | 'es-ea' | 'es-ec' | 'es-es' | 'es-gq' | 'es-gt' | 'es-hn' | 'es-ic' | 'es-mx' | 'es-ni' | 'es-pa' | 'es-pe' | 'es-ph' | 'es-pr' | 'es-py' | 'es-sv' | 'es-us' | 'es-uy' | 'es-ve' | 'et' | 'et-ee' | 'eu' | 'eu-es' | 'ewo' | 'ewo-cm' | 'fa' | 'fa-af' | 'fa-ir' | 'ff' | 'ff-bf' | 'ff-cm' | 'ff-gh' | 'ff-gm' | 'ff-gn' | 'ff-gw' | 'ff-lr' | 'ff-mr' | 'ff-ne' | 'ff-ng' | 'ff-sl' | 'ff-sn' | 'fi' | 'fi-fi' | 'fil' | 'fil-ph' | 'fj' | 'fo' | 'fo-dk' | 'fo-fo' | 'fr' | 'fr-be' | 'fr-bf' | 'fr-bi' | 'fr-bj' | 'fr-bl' | 'fr-ca' | 'fr-cd' | 'fr-cf' | 'fr-cg' | 'fr-ch' | 'fr-ci' | 'fr-cm' | 'fr-dj' | 'fr-dz' | 'fr-fr' | 'fr-ga' | 'fr-gf' | 'fr-gn' | 'fr-gp' | 'fr-gq' | 'fr-ht' | 'fr-km' | 'fr-lu' | 'fr-ma' | 'fr-mc' | 'fr-mf' | 'fr-mg' | 'fr-ml' | 'fr-mq' | 'fr-mr' | 'fr-mu' | 'fr-nc' | 'fr-ne' | 'fr-pf' | 'fr-pm' | 'fr-re' | 'fr-rw' | 'fr-sc' | 'fr-sn' | 'fr-sy' | 'fr-td' | 'fr-tg' | 'fr-tn' | 'fr-vu' | 'fr-wf' | 'fr-yt' | 'frr' | 'frr-de' | 'fur' | 'fur-it' | 'fy' | 'fy-nl' | 'ga' | 'ga-gb' | 'ga-ie' | 'gaa' | 'gaa-gh' | 'gd' | 'gd-gb' | 'gl' | 'gl-es' | 'gn' | 'gsw' | 'gsw-ch' | 'gsw-fr' | 'gsw-li' | 'gu' | 'gu-in' | 'guz' | 'guz-ke' | 'gv' | 'gv-im' | 'ha' | 'ha-gh' | 'ha-ne' | 'ha-ng' | 'haw' | 'haw-us' | 'he' | 'he-il' | 'hi' | 'hi-in' | 'hmn' | 'ho' | 'hr' | 'hr-ba' | 'hr-hr' | 'hsb' | 'hsb-de' | 'ht' | 'ht-ht' | 'hu' | 'hu-hu' | 'hy' | 'hy-am' | 'hz' | 'ia' | 'ia-001' | 'id' | 'id-id' | 'ie' | 'ie-ee' | 'ig' | 'ig-ng' | 'ii' | 'ii-cn' | 'ik' | 'io' | 'is' | 'is-is' | 'it' | 'it-ch' | 'it-it' | 'it-sm' | 'it-va' | 'iu' | 'ja' | 'ja-jp' | 'jgo' | 'jgo-cm' | 'jmc' | 'jmc-tz' | 'jv' | 'jv-id' | 'ka' | 'ka-ge' | 'kab' | 'kab-dz' | 'kam' | 'kam-ke' | 'kar' | 'kde' | 'kde-tz' | 'kea' | 'kea-cv' | 'kg' | 'kgp' | 'kgp-br' | 'kh' | 'khq' | 'khq-ml' | 'ki' | 'ki-ke' | 'kj' | 'kk' | 'kk-kz' | 'kkj' | 'kkj-cm' | 'kl' | 'kl-gl' | 'kln' | 'kln-ke' | 'km' | 'km-kh' | 'kn' | 'kn-in' | 'ko' | 'ko-cn' | 'ko-kp' | 'ko-kr' | 'kok' | 'kok-in' | 'kr' | 'ks' | 'ks-in' | 'ksb' | 'ksb-tz' | 'ksf' | 'ksf-cm' | 'ksh' | 'ksh-de' | 'ku' | 'ku-tr' | 'kv' | 'kw' | 'kw-gb' | 'kxv' | 'kxv-in' | 'ky' | 'ky-kg' | 'la' | 'lag' | 'lag-tz' | 'lb' | 'lb-lu' | 'lg' | 'lg-ug' | 'li' | 'lij' | 'lij-it' | 'lkt' | 'lkt-us' | 'lmo' | 'lmo-it' | 'ln' | 'ln-ao' | 'ln-cd' | 'ln-cf' | 'ln-cg' | 'lo' | 'lo-la' | 'lrc' | 'lrc-iq' | 'lrc-ir' | 'lt' | 'lt-lt' | 'lu' | 'lu-cd' | 'luo' | 'luo-ke' | 'luy' | 'luy-ke' | 'lv' | 'lv-lv' | 'mai' | 'mai-in' | 'mas' | 'mas-ke' | 'mas-tz' | 'mdf' | 'mdf-ru' | 'mer' | 'mer-ke' | 'mfe' | 'mfe-mu' | 'mg' | 'mg-mg' | 'mgh' | 'mgh-mz' | 'mgo' | 'mgo-cm' | 'mh' | 'mi' | 'mi-nz' | 'mk' | 'mk-mk' | 'ml' | 'ml-in' | 'mn' | 'mn-mn' | 'mni' | 'mni-in' | 'mr' | 'mr-in' | 'ms' | 'ms-bn' | 'ms-id' | 'ms-my' | 'ms-sg' | 'mt' | 'mt-mt' | 'mua' | 'mua-cm' | 'my' | 'my-mm' | 'mzn' | 'mzn-ir' | 'na' | 'naq' | 'naq-na' | 'nb' | 'nb-no' | 'nb-sj' | 'nd' | 'nd-zw' | 'nds' | 'nds-de' | 'nds-nl' | 'ne' | 'ne-in' | 'ne-np' | 'ng' | 'nl' | 'nl-aw' | 'nl-be' | 'nl-bq' | 'nl-ch' | 'nl-cw' | 'nl-lu' | 'nl-nl' | 'nl-sr' | 'nl-sx' | 'nmg' | 'nmg-cm' | 'nn' | 'nn-no' | 'nnh' | 'nnh-cm' | 'no' | 'no-no' | 'nqo' | 'nqo-gn' | 'nr' | 'nso' | 'nso-za' | 'nus' | 'nus-ss' | 'nv' | 'ny' | 'nyn' | 'nyn-ug' | 'oc' | 'oc-es' | 'oc-fr' | 'oj' | 'om' | 'om-et' | 'om-ke' | 'or' | 'or-in' | 'os' | 'os-ge' | 'os-ru' | 'pa' | 'pa-in' | 'pa-pk' | 'pcm' | 'pcm-ng' | 'pi' | 'pis' | 'pis-sb' | 'pl' | 'pl-pl' | 'prg' | 'prg-001' | 'ps' | 'ps-af' | 'ps-pk' | 'pt' | 'pt-ao' | 'pt-br' | 'pt-ch' | 'pt-cv' | 'pt-gq' | 'pt-gw' | 'pt-lu' | 'pt-mo' | 'pt-mz' | 'pt-pt' | 'pt-st' | 'pt-tl' | 'qu' | 'qu-bo' | 'qu-ec' | 'qu-pe' | 'raj' | 'raj-in' | 'rm' | 'rm-ch' | 'rn' | 'rn-bi' | 'ro' | 'ro-md' | 'ro-ro' | 'rof' | 'rof-tz' | 'ru' | 'ru-by' | 'ru-kg' | 'ru-kz' | 'ru-md' | 'ru-ru' | 'ru-ua' | 'rw' | 'rw-rw' | 'rwk' | 'rwk-tz' | 'sa' | 'sa-in' | 'sah' | 'sah-ru' | 'saq' | 'saq-ke' | 'sat' | 'sat-in' | 'sbp' | 'sbp-tz' | 'sc' | 'sc-it' | 'sd' | 'sd-in' | 'sd-pk' | 'se' | 'se-fi' | 'se-no' | 'se-se' | 'seh' | 'seh-mz' | 'ses' | 'ses-ml' | 'sg' | 'sg-cf' | 'shi' | 'shi-ma' | 'si' | 'si-lk' | 'sk' | 'sk-sk' | 'sl' | 'sl-si' | 'sm' | 'smn' | 'smn-fi' | 'sms' | 'sms-fi' | 'sn' | 'sn-zw' | 'so' | 'so-dj' | 'so-et' | 'so-ke' | 'so-so' | 'sq' | 'sq-al' | 'sq-mk' | 'sq-xk' | 'sr' | 'sr-ba' | 'sr-cs' | 'sr-me' | 'sr-rs' | 'sr-xk' | 'ss' | 'st' | 'st-ls' | 'st-za' | 'su' | 'su-id' | 'sv' | 'sv-ax' | 'sv-fi' | 'sv-se' | 'sw' | 'sw-cd' | 'sw-ke' | 'sw-tz' | 'sw-ug' | 'sy' | 'syr' | 'syr-iq' | 'syr-sy' | 'szl' | 'szl-pl' | 'ta' | 'ta-in' | 'ta-lk' | 'ta-my' | 'ta-sg' | 'te' | 'te-in' | 'teo' | 'teo-ke' | 'teo-ug' | 'tg' | 'tg-tj' | 'th' | 'th-th' | 'ti' | 'ti-er' | 'ti-et' | 'tk' | 'tk-tm' | 'tl' | 'tn' | 'tn-bw' | 'tn-za' | 'to' | 'to-to' | 'tok' | 'tok-001' | 'tr' | 'tr-cy' | 'tr-tr' | 'ts' | 'tt' | 'tt-ru' | 'tw' | 'twq' | 'twq-ne' | 'ty' | 'tzm' | 'tzm-ma' | 'ug' | 'ug-cn' | 'uk' | 'uk-ua' | 'ur' | 'ur-in' | 'ur-pk' | 'uz' | 'uz-af' | 'uz-uz' | 'vai' | 'vai-lr' | 've' | 'vec' | 'vec-it' | 'vi' | 'vi-vn' | 'vmw' | 'vmw-mz' | 'vo' | 'vo-001' | 'vun' | 'vun-tz' | 'wa' | 'wae' | 'wae-ch' | 'wo' | 'wo-sn' | 'xh' | 'xh-za' | 'xnr' | 'xnr-in' | 'xog' | 'xog-ug' | 'yav' | 'yav-cm' | 'yi' | 'yi-001' | 'yi-ua' | 'yo' | 'yo-bj' | 'yo-ng' | 'yrl' | 'yrl-br' | 'yrl-co' | 'yrl-ve' | 'yue' | 'yue-cn' | 'yue-hk' | 'yue-mo' | 'za' | 'za-cn' | 'zgh' | 'zgh-ma' | 'zh' | 'zh-cn' | 'zh-hans' | 'zh-hant' | 'zh-hk' | 'zh-mo' | 'zh-my' | 'zh-sg' | 'zh-tw' | 'zu' | 'zu-za': The language code of the email, following ISO 639-1 and ISO 3166-1 standards. - `name` string: The name of the email, as displayed on the email dashboard. - `previewKey` string: The preview key for the email. - `primaryEmailCampaignId` string: The primary email campaign ID associated with the email. - `publishDate` string, date-time: The date and time the email is scheduled for, in ISO8601 representation. This is only used in local time or scheduled emails. - `publishedAt` string, date-time: The date and time the email was published at, in ISO8601 representation. - `publishedByEmail` string: Email of the user who published/sent the email. - `publishedById` string: The ID of the user who published the email. - `publishedByName` string: Name of the user who published the email. - `rssData` PublicRssEmailDetails - `blogEmailType` string: A string representing the type of blog email. - `blogImageMaxWidth` integer: The maximum width for images in the blog, specified as an integer. - `blogLayout` 'FULL_POST' | 'SUMMARY_NO_FEATURED_IMAGE' | 'SUMMARY_WITH_FEATURED_IMAGE': The layout of the blog in the email. Valid values include 'SUMMARY_NO_FEATURED_IMAGE', 'SUMMARY_WITH_FEATURED_IMAGE', and 'FULL_POST'. - `hubspotBlogId` string: The unique identifier of the HubSpot blog associated with the RSS email. It is a string. - `maxEntries` integer: The maximum number of entries to include from the RSS feed. It is an integer value. - `rssEntryTemplate` string: A string representing the template used for each RSS entry in the email. - `timing` object: An object representing the timing configuration for the RSS email. The specific properties of this object are not detailed in the specification. - `url` string: The URL of the RSS feed to be used in the email. It is a string. - `useHeadlineAsSubject` boolean: A boolean indicating whether to use the headline of the RSS entry as the subject of the email. - `sendOnPublish` boolean: Determines whether the email will be sent immediately on publish. - `state` 'AGENT_GENERATED' | 'AUTOMATED' | 'AUTOMATED_AB' | 'AUTOMATED_AB_VARIANT' | 'AUTOMATED_DRAFT' | 'AUTOMATED_DRAFT_AB' | 'AUTOMATED_DRAFT_ABVARIANT' | 'AUTOMATED_FOR_FORM' | 'AUTOMATED_FOR_FORM_BUFFER' | 'AUTOMATED_FOR_FORM_DRAFT' | 'AUTOMATED_FOR_FORM_LEGACY' | 'AUTOMATED_LOSER_ABVARIANT' | 'AUTOMATED_SENDING' | 'BLOG_EMAIL_DRAFT' | 'BLOG_EMAIL_PUBLISHED' | 'DRAFT' | 'DRAFT_AB' | 'DRAFT_AB_VARIANT' | 'ERROR' | 'LOSER_AB_VARIANT' | 'PAGE_STUB' | 'PRE_PROCESSING' | 'PROCESSING' | 'PUBLISHED' | 'PUBLISHED_AB' | 'PUBLISHED_AB_VARIANT' | 'PUBLISHED_OR_SCHEDULED' | 'RSS_TO_EMAIL_DRAFT' | 'RSS_TO_EMAIL_PUBLISHED' | 'SCHEDULED' | 'SCHEDULED_AB' | 'SCHEDULED_OR_PUBLISHED': The email state. - `stats` EmailStatisticsData - `counters` object, required: Counters like number of `sent`, `open` or `delivered`. - `deviceBreakdown` object, required: Statistics by device. - `qualifierStats` object, required: Number of emails that were dropped and bounced. - `ratios` object, required: Ratios like `openratio` or `clickratio` - `subcategory` string: The email subcategory. - `subject` string: The subject of the email. - `subscriptionDetails` PublicEmailSubscriptionDetails - `officeLocationId` string: ID of the selected office location. - `preferencesGroupId` string: The identifier for the preferences group associated with the subscription. It is a string value. - `subscriptionId` string: ID of the subscription. - `subscriptionName` string: The name of the email subscription. It is a string value. - `teamsWithAccess` string[]: An array of team IDs who have access to the email. - `testing` PublicEmailTestingDetails - `abSampleSizeDefault` 'automated_loser_variant' | 'automated_master' | 'automated_variant' | 'loser_variant' | 'mab_master' | 'mab_variant' | 'master' | 'variant': Version of the email that should be sent if there are too few recipients to conduct an AB test. - `abSamplingDefault` 'automated_loser_variant' | 'automated_master' | 'automated_variant' | 'loser_variant' | 'mab_master' | 'mab_variant' | 'master' | 'variant': Version of the email that should be sent if the results are inconclusive after the test period, master or variant. - `abStatus` 'automated_loser_variant' | 'automated_master' | 'automated_variant' | 'loser_variant' | 'mab_master' | 'mab_variant' | 'master' | 'variant': Status of the AB test. - `abSuccessMetric` 'CLICKS_BY_DELIVERED' | 'CLICKS_BY_OPENS' | 'OPENS_BY_DELIVERED': Metric to determine the version that will be sent to the remaining contacts. - `abTestPercentage` integer: The size of your test group. - `hoursToWait` integer: Time limit on gathering test results. After this time is up, the winning version will be sent to the remaining contacts. - `isAbVariation` boolean, required: A boolean indicating whether the email is an A/B test variation. - `testId` string: The ID of the AB test. - `to` PublicEmailToDetails - `contactIds` PublicEmailRecipients - `exclude` string[]: Excluded IDs. - `include` string[]: Included IDs. - `contactIlsLists` PublicEmailRecipients - `exclude` string[]: Excluded IDs. - `include` string[]: Included IDs. - `contactLists` PublicEmailRecipients - `exclude` string[]: Excluded IDs. - `include` string[]: Included IDs. - `limitSendFrequency` boolean: A boolean indicating whether the frequency of sending emails to the recipients should be limited. - `suppressGraymail` boolean: Whether to send to unengaged contacts (false) or not (true). - `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': The email type, this is derived from other properties on the email such as subcategory. - `unpublishedAt` string, date-time: The date and time when the email was unpublished, in ISO 8601 format. - `updatedAt` string, date-time: The date and time of the last update to the email, in ISO8601 representation. - `updatedById` string: The id of the user who last updated the email. - `usersWithAccess` string[]: An array of user IDs who have access to the email. - `webversion` PublicWebversionDetails - `domain` string: A string specifying the domain where the web version of the email is hosted. - `enabled` boolean: A boolean indicating whether the web version of the email is enabled. - `expiresAt` string, date-time: A string in date-time format specifying when the web version page will expire. - `isPageRedirected` boolean: A boolean indicating whether the web version page is redirected to another URL. - `metaDescription` string: A string providing the meta description for the web version of the email. - `pageExpiryEnabled` boolean: A boolean indicating whether the web version page has an expiry set. - `redirectToPageId` string: A string representing the ID of the page to which the web version is redirected. - `redirectToUrl` string: A string containing the URL to which the web version page is redirected. - `slug` string: A string representing the unique slug for the web version of the email. - `title` string: A string representing the title of the web version of the email. - `url` string: A string containing the full URL of the web version of the email. - `workflowNames` string[]: Names of workflows in which the email is used within a "send email" action. - `total` integer, required: An integer representing the total number of public emails available. ## Other responses - `default`: An error occurred. ## Changes - **2026-10-14** (2026-09) `63a409723776`: 2 info - the security scope `marketing.email.read` was added to the endpoint's security scheme `oauth2` - the security scope `content` was removed from the endpoint's security scheme `oauth2` - **2026-10-10** (2026-09) `f3d5b6124704`: 2 info - the security scope `marketing.email.read` was added to the endpoint's security scheme `oauth2` - the security scope `content` was removed from the endpoint's security scheme `oauth2` - **2026-10-01** (2026-09) `f3d5b6124704`: 2 info - the security scope `marketing.email.read` was added to the endpoint's security scheme `oauth2` - the security scope `content` was removed from the endpoint's security scheme `oauth2` - **2026-09-28** (2026-09) `785f0c0a0606`: 2 info - the security scope `marketing.email.read` was added to the endpoint's security scheme `oauth2` - the security scope `content` was removed from the endpoint's security scheme `oauth2` - **2026-09-22** (2026-09) `d438170df2ce`: 2 info - the security scope `marketing.email.read` was added to the endpoint's security scheme `oauth2` - the security scope `content` was removed from the endpoint's security scheme `oauth2` [Operation history](https://skmtc.dev/hubspot/apis/marketing-marketing-emails/changes/marketing/emails/2026-09/get.md) --- [API](https://skmtc.dev/hubspot/apis/marketing-marketing-emails.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-marketing-emails/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-marketing-emails/revisions/63a409723776?raw)