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.

List Templates

Last updated June 17, 2020

GET /content/api/v2/templates

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Get all templates. Supports paging and filtering.

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 query string filters & options

If a parameter supports a filter type of 'gt', that means you can append a double underscore to the parameter name to find all items greater than the value.
Parameter name Description
limit The number of items to return. Defaults to 20
offset The offset set to start returning rows from. Defaults to 0.
deleted_at exact, gt, lt
id exact
is_available_for_new_content exact
label exact
path exact

JSON Fields returned in the response

Parameter name Type Description
archived bool If True, the template will not show up in your dashboard, although the template will still be live
category_id string The category of content this template can be used for. 1 for landing page, 2 for email, 3 for site page
cdn_minified_url string For JavaScript and CSS, this is the URL of the version of the content that has been rendered, minified, and uploaded to our Content Delivery Network
cdn_url string For non-HTML templates, the URL to the version of the template that has been rendered and uploaded to the HubSpot CDN
deleted_at long When the template was deleted, in milliseconds since the epoch. Zero if the template was never deleted. Use a DELETE request to template the page, do not set this directly.
folder string The folder this template lives in
generated_from_layout_id string The id of the layout that generated this template
id string The unique id of the template
is_available_for_new_content string True if this template will show up in the content creation screen
is_from_layout string True if template was generated by publishing a layout
is_read_only string True if the template can only be read
label string The label of the template as it shows up in the template builder
path string The path of the template, as should be used for HubL include statements
source string The markup of the template
thumbnail_path string The thumbnail image of the template
updated long When the template was last updated, in milliseconds since the epoch

Example URL: