There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Get all marketing emails for a HubSpot account.
The results can be filtered, allowing you to find a specific set of emails you're searching for. See the table below for a full list of filtering options.
| Required Parameters | How to use | Description |
|---|---|---|
| OAuth access token or private app access token | Authorization: Bearer {token} header | Used to authenticate the request. Please see this page for more details about authentication. |
| Optional Parameters | How to use | Description |
|---|---|---|
| Limit | &limit= Used in the request URL |
The number of records to return in the response. Defaults to 10. Note: A hard limit of 300 records returned. |
| Offset | &offset= Used in the request URL |
Used to get the next page of results. Use the limit of the previous request as the offset to get the next set of results. |
| Order by | &orderBy= Used in the request URL |
Return the emails ordered by a particular field value. Use a negative value to sort in descending order (e.g. orderBy=-created). |
Results can be filtered based on specific fields. You can filter for a field by including it as a query parameter. For example, you can filter by campaign by including &campaign=:campaign_id in the request URL.
In addition to filtering for an exact match, some fields support other filter types, designated by including two underscores between the field name and the type. For example, you can filter for emails created after December 31, 2018, by including &created__gt=1546318800000 in the request URL.
The list of fields that support filtering, and the supported filter types for those fields are listed below.
| Field name | Supported filter types |
|---|---|
| ab_status | eq, exact, in, is, ne, neq, nin, not |
| ab_test_id | eq, exact, is |
| analytics_page_id | eq, exact, is |
| archived | eq, exact, is |
| campaign | eq, exact, is |
| content_group_id | eq, exact, is, in |
| content_type_id | eq, exact, is |
| created | eq, exact, gt, gte, is, lt, lte, range |
| created_by_id | eq, exact, is |
| domain | contains, eq, exact, is, like, nlike, not_like |
| folder_id | eq, exact, in, is, is_null, not_null |
| name | eq, exact, is, in, ilike, icontains |
| publish_date | eq, exact, gt, gte, is, lt, lte, range |
| subcategory | eq, exact, in, is, ne, neq, nin, not |
| template_path | contains, eq, exact, is, like |
| updated | eq, exact, gt, gte, is, lt, lte, range |
| updated_by_id | eq, exact, is |
Hi there,
Describe what you have to offer the customer. Why should they read? What did you promise them in the subject line? Tell them something cool. Make them laugh. Make them cry. Well, maybe don't do that...
Use a list to:
LINK TO A LANDING PAGE ON YOUR SITE (This is the really important part.)
Now wrap it all up with a pithy little reminder of how much you love them.
Aw. You silver-tongued devil, you.
Sincerely,
Your name
Hi there,
Describe what you have to offer the customer. Why should they read? What did you promise them in the subject line? Tell them something cool. Make them laugh. Make them cry. Well, maybe don't do that...
Use a list to:
LINK TO A LANDING PAGE ON YOUR SITE (This is the really important part.)
Now wrap it all up with a pithy little reminder of how much you love them.
Aw. You silver-tongued devil, you.
Sincerely,
Your name
Hi there,
Describe what you have to offer the customer. Why should they read? What did you promise them in the subject line? Tell them something cool. Make them laugh. Make them cry. Well, maybe don't do that...
Use a list to:
LINK TO A LANDING PAGE ON YOUR SITE (This is the really important part.)
Now wrap it all up with a pithy little reminder of how much you love them.
Aw. You silver-tongued devil, you.
Sincerely,
Your name
", "htmlTitle": "", "id": 6881348238, "isGraymailSuppressionEnabled": false, "isLocalTimezoneSend": false, "isPublished": false, "isRecipientFatigueSuppressionEnabled": false, "lastEditSessionId": 1546532086218, "lastEditUpdateId": 2, "layoutSections": {}, "leadFlowId": null, "liveDomain": "demo-hubapi.hs-sites.com", "mailingListsExcluded": [], "mailingListsIncluded": [], "maxRssEntries": 5, "metaDescription": "", "name": "Some task", "pageExpiryEnabled": false, "pageRedirected": false, "portalId": 62515, "previewKey": "qrXZMugK", "primaryRichTextModuleHtml": "Hi there,
Describe what you have to offer the customer. Why should they read? What did you promise them in the subject line? Tell them something cool. Make them laugh. Make them cry. Well, maybe don't do that...
Use a list to:
LINK TO A LANDING PAGE ON YOUR SITE (This is the really important part.)
Now wrap it all up with a pithy little reminder of how much you love them.
Aw. You silver-tongued devil, you.
Sincerely,
Your name
", "processingStatus": "", "publishDate": 1546101623000, "publishImmediately": false, "publishedUrl": "", "replyTo": "", "resolvedDomain": "demo-hubapi.hs-sites.com", "rssEmailByText": "By", "rssEmailClickThroughText": "Read more »", "rssEmailCommentText": "Comment »", "rssEmailEntryTemplateEnabled": false, "rssEmailImageMaxWidth": 0, "rssEmailUrl": "", "slug": "-temporary-slug-63880d53-413f-4550-9ddf-396c8b0b06d5", "smartEmailFields": {}, "state": "AUTOMATED_DRAFT", "styleSettings": null, "subcategory": "single_send_api", "subject": "Some task", "teamPerms": [], "templatePath": "hubspot_default/email/responsive/1_column_above_body.html", "transactional": false, "unpublishedAt": 0, "updated": 1546532153459, "url": "http://demo-hubapi.hs-sites.com/-temporary-slug-63880d53-413f-4550-9ddf-396c8b0b06d5", "useRssHeadlineAsSubject": false, "userPerms": [], "vidsExcluded": [], "vidsIncluded": [], "widgets": { "Social_Sharing": { "body": {}, "child_css": {}, "css": {}, "id": "Social_Sharing", "label": "Social Sharing", "name": "Social_Sharing", "order": 5, "smart_type": null, "type": "social_sharing" }, "column1": { "body": { "html": "This is a rich text column
Say something fun and important, maybe add an image or two.
" }, "child_css": {}, "css": {}, "id": "column1", "label": "Column Above Body", "name": "column1", "order": 2, "smart_type": null, "type": "rich_text" }, "hs_email_body": { "body": { "html": "Hi there,
Describe what you have to offer the customer. Why should they read? What did you promise them in the subject line? Tell them something cool. Make them laugh. Make them cry. Well, maybe don't do that...
Use a list to:
LINK TO A LANDING PAGE ON YOUR SITE (This is the really important part.)
Now wrap it all up with a pithy little reminder of how much you love them.
Aw. You silver-tongued devil, you.
Sincerely,
Your name
" }, "child_css": {}, "css": {}, "id": "hs_email_body", "label": "Main Email Body", "name": "hs_email_body", "order": 3, "smart_type": null, "type": "rich_text" }, "logo_image": { "body": { "alt": "Expressions-10.jpg", "height": 466, "link": "https://www.example.com", "override_inherited_src": false, "src": "", "suppress_company_name": true, "width": 370 }, "child_css": {}, "css": {}, "id": "logo_image", "label": "Logo", "name": "logo_image", "order": 1, "smart_type": null, "type": "logo" }, "preview_text": { "body": { "value": "" }, "child_css": {}, "css": {}, "id": "preview_text", "label": "Preview Text This will be used as the preview text that displays in some email clients", "name": "preview_text", "order": 0, "smart_type": null, "type": "text" }, "social_sharing_label": { "body": {}, "child_css": {}, "css": {}, "id": "social_sharing_label", "label": "Social Sharing Label", "name": "social_sharing_label", "order": 4, "smart_type": null, "type": "text" } } } ], "offset": 0, "total": 33, "totalCount": 33 }
![](\"http://cdn2.hubspot.net/hub/177948/file-5125693-png\")