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.

List Templates

Last updated May 15, 2023

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 private app access token Authorization: Bearer {token} header 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: