There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Create a new Template

Last updated November 19, 2021

POST /content/api/v2/templates

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Create a new coded template object in Design Manager.

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.
Additional Parameters Description
category_id This parameter category type:

  • 0 - Unmapped
  • 1 - Landing Pages
  • 2 - Email
  • 3 - Blog Post
  • 4 - Site Page
folder The name of the folder to save the template in Design Manager.
template_type This parameter accepts a numeric value and sets the type of template that is created. The following numbers correspond to specific template types:

  • 2 - Email template
  • 4 - Page template
  • 11 - Error template
  • 12 - Subscription preferences template
  • 13 - Backup unsubscribe page template
  • 14 - Subscriptions update confirmation template
  • 19 - Password prompt page template
  • 27 - Search results template
  • 29 - Membership login template
  • 30 - Membership registration template
  • 31 - Membership reset password confirmation template
  • 32 - Membership reset password request template
path The Design Manager path to the directory that contains the file being created
source The source code of the file.
  • Used to determine if the template should be expected to pass page/content validation and be used with live content (if "True", the template source must contain the required variables for the template type).
  • This is equivalent to the "Make Available for New Content?" checkbox on Publish in the UI, and the "Template" vs. "Template Partial" radio select on template creation in the design manager beta.
  • Default value is "False".