Email templates (BETA) - HubSpot docs

Scope requirements

Use the email templates API to create and manage sales email templates in your HubSpot account. Sales email templates are reusable email layouts that your team can use to send consistent, personalized emails to contacts.

Create an email template

To create a new email template, make a POST request to /automation/email-templates/2026-09-beta/. In your request body, include the template’s name and body, and optionally include the email’s subject and folderId. For example, the request body will resemble the following:

{
  "name": "Welcome follow-up",
  "subject": "Following up on your interest",
  "body": "<p>Hi {{contact.firstname}},</p><p>Thanks for your interest in our product. I'd love to schedule a quick call to discuss how we can help.</p><p>Best,<br>{{sender.firstname}}</p>",
  "folderId": "123456"
}

Parameter	Type	Description
`name`	String	The name of the email template.
`body`	String	The HTML body content of the email template.
`subject`	String	The subject line of the email template.
`folderId`	String	The ID of the folder to place the template in.

The response will include the template’s details, including the template’s unique id and other metadata.

{
  "id": "987654321",
  "name": "Welcome follow-up",
  "subject": "Following up on your interest",
  "body": "<p>Hi {{contact.firstname}},</p><p>Thanks for your interest in our product. I'd love to schedule a quick call to discuss how we can help.</p><p>Best,<br>{{sender.firstname}}</p>",
  "folderId": "123456",
  "ownerId": "2222222",
  "createdAt": 1722470400000,
  "updatedAt": 1722470400000
}

Retrieve email templates

You can retrieve all email templates or a specific template by its ID.

Retrieve all email templates

To retrieve a list of all email templates, make a GET request to /automation/email-templates/2026-09-beta/. You can include the following query parameters in your request URL:

Parameter	Description
`limit`	The maximum number of results to display per page. Default is `20`.
`after`	The paging cursor token of the last successfully read resource. Use the `paging.next.after` value from a previous response to retrieve the next page of results.

For example, to retrieve 50 email templates, your request URL would be GET /automation/email-templates/2026-09-beta?limit=50. The code block below provides an example response, highlighting the after property, under the paging object, used as a cursor to retrieve the next page of results (e.g., /automation/email-templates/2026-09-beta?limit=50&after={after}).

{
  "results": [
    {
      "id": "987654321",
      "name": "Welcome follow-up",
      "subject": "Following up on your interest",
      "body": "<p>Hi {{contact.firstname}},</p>...",
      "folderId": "123456",
      "ownerId": "2222222",
      "createdAt": 1722470400000,
      "updatedAt": 1722470400000
    }
  ],
  "paging": {
    "next": {
      "after": "987654322",
      "link": "https://api.hubapi.com/automation/email-templates/2026-09-beta?limit=50&after=987654322"
    }
  }
}

Retrieve a specific email template

To retrieve a specific email template, make a GET request to /automation/email-templates/2026-09-beta/{templateId}. Use the template’s id as the templateId path parameter. For example, to retrieve a template with ID 987654321, make a GET request to /automation/email-templates/2026-09-beta/987654321. The response would resemble the following:

{
  "id": "987654321",
  "name": "Welcome follow-up",
  "subject": "Following up on your interest",
  "body": "<p>Hi {{contact.firstname}},</p><p>Thanks for your interest in our product. I'd love to schedule a quick call to discuss how we can help.</p><p>Best,<br>{{sender.firstname}}</p>",
  "folderId": "123456",
  "ownerId": "2222222",
  "createdAt": 1722470400000,
  "updatedAt": 1722470400000
}

Update an email template

To update an existing email template, make a PATCH request to /automation/email-templates/2026-09-beta/{templateId}. Use the template’s id as the templateId path parameter. In the request body, include the fields you want to update. For example, to update a template’s name and subject, the request body would resemble the following:

{
  "name": "Welcome follow-up - Updated",
  "subject": "Quick follow-up"
}

Parameter	Type	Description
`name`	String	The updated name of the email template.
`subject`	String	The updated subject line of the email template.
`body`	String	The updated HTML body content of the email template.
`folderId`	String	The updated folder ID for the template.

The response will include the updated template details:

{
  "id": "987654321",
  "name": "Welcome follow-up - Updated",
  "subject": "Quick follow-up",
  "body": "<p>Hi {{contact.firstname}},</p><p>Thanks for your interest in our product. I'd love to schedule a quick call to discuss how we can help.</p><p>Best,<br>{{sender.firstname}}</p>",
  "folderId": "123456",
  "ownerId": "2222222",
  "createdAt": 1722470400000,
  "updatedAt": 1722556800000
}

Retrieve folders

Folders are used to organize email templates in your HubSpot account. To retrieve a list of all folders, make a GET request to /automation/email-templates/2026-09-beta/folders. You can include the following query parameters in your request URL:

Parameter	Description
`limit`	The maximum number of results to display per page. Default is `20`.
`after`	The paging cursor token of the last successfully read resource. Use the `paging.next.after` value from a previous response to retrieve the next page of results.

For example, to retrieve a list of folders and limit the results to 50 entries, your request URL would be GET /automation/email-templates/2026-09-beta/folders?limit=50. The response will resemble the following:

{
  "results": [
    {
      "id": "123456",
      "name": "Onboarding templates",
      "createdAt": 1722470400000,
      "updatedAt": 1722470400000
    }
  ],
  "paging": {
    "next": {
      "after": "123457",
      "link": "https://api.hubapi.com/automation/email-templates/2026-09-beta/folders?limit=50&after=123457"
    }
  }
}

​Create an email template

​Retrieve email templates

​Retrieve all email templates

​Retrieve a specific email template

​Update an email template

​Retrieve folders