There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.
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 API Key | Authorization: Bearer {token} header or hapikey={key} query parameter. |
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 {{contact.firstname}},
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 {{contact.firstname}},
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 {{contact.firstname}},
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\")