List Templates

curl --request GET \
  --url https://api.hubapi.com/content/api/v2/templates

{
  "total_count": 123,
  "objects": [
    {
      "id": "<string>",
      "label": "<string>",
      "path": "<string>",
      "source": "<string>",
      "category_id": 123,
      "template_type": "<string>",
      "folder": "<string>",
      "is_available_for_new_content": true,
      "is_from_layout": true,
      "is_read_only": true,
      "cdn_url": "<string>",
      "cdn_minified_url": "<string>",
      "deleted_at": 123,
      "generated_from_layout_id": "<string>",
      "thumbnail_path": "<string>",
      "thumbnail_width": 123,
      "updated": 123,
      "updated_by": "<string>",
      "portal_id": 123,
      "archived": true,
      "linked_style_id": "<string>",
      "type": "<string>"
    }
  ],
  "limit": 123,
  "offset": 123
}

GET

content

api

templates

List Templates

curl --request GET \
  --url https://api.hubapi.com/content/api/v2/templates

{
  "total_count": 123,
  "objects": [
    {
      "id": "<string>",
      "label": "<string>",
      "path": "<string>",
      "source": "<string>",
      "category_id": 123,
      "template_type": "<string>",
      "folder": "<string>",
      "is_available_for_new_content": true,
      "is_from_layout": true,
      "is_read_only": true,
      "cdn_url": "<string>",
      "cdn_minified_url": "<string>",
      "deleted_at": 123,
      "generated_from_layout_id": "<string>",
      "thumbnail_path": "<string>",
      "thumbnail_width": 123,
      "updated": 123,
      "updated_by": "<string>",
      "portal_id": 123,
      "archived": true,
      "linked_style_id": "<string>",
      "type": "<string>"
    }
  ],
  "limit": 123,
  "offset": 123
}

Scope requirements

Query Parameters

limit

integer

default:20

The number of items to return. Defaults to 20.

offset

integer

default:0

The offset set to start returning rows from. Defaults to 0.

deleted_at

string

Filter by deleted_at timestamp (exact, gt, lt)

string

Filter by template ID (exact)

is_available_for_new_content

boolean

Filter by availability for new content (exact)

label

string

Filter by template label (exact)

path

string

Filter by template path (exact)

Response

200 - application/json

successful operation

total_count

integer

objects

object[]

Show child attributes

objects.id

string

The unique id of the template

objects.label

string

The label of the template as it shows up in the template builder

objects.path

string

The path of the template, as should be used for HubL include statements

objects.source

string

The markup of the template

objects.category_id

integer

The category of content this template can be used for. 1 for landing page, 2 for email, 3 for site page

objects.template_type

string

The type of template

objects.folder

string

The folder this template lives in

objects.is_available_for_new_content

boolean

True if this template will show up in the content creation screen

objects.is_from_layout

boolean

True if template was generated by publishing a layout

objects.is_read_only

boolean

True if the template can only be read

objects.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

objects.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

objects.deleted_at

integer

When the template was deleted, in milliseconds since the epoch. Zero if the template was never deleted.

objects.generated_from_layout_id

string

The id of the layout that generated this template

objects.thumbnail_path

string

The thumbnail image of the template

objects.thumbnail_width

integer

The width of the thumbnail image

objects.updated

integer

When the template was last updated, in milliseconds since the epoch

objects.updated_by

string

Who last updated the template

objects.portal_id

integer

The portal/account ID

objects.archived

boolean

If True, the template will not show up in your dashboard, although the template will still be live

objects.linked_style_id

string

ID of linked stylesheet

objects.type

string

Template type field

limit

integer

offset

integer

Last modified on December 12, 2025