---
title: "Create an email template"
method: POST
path: "/api/email_templates"
tags: ["EmailTemplates"]
---

# Create an email template

`POST /api/email_templates`

Create an email template used to send emails conditional on events like policy evaluation

## Request body

- EmailTemplateSchema
  - `cc_address` string, nullable — The email address to CC
  - `heron_id` string — Unique identifier for the email template
  - `html_body` string, required — The body of the email to send.
  - `name` string, required — Unique name of the email template. Used to match which email template to send. Only alphanumeric characters, underscores, and dashes are allowed.
  - `reply_to_address` string, nullable — The email address to reply to
  - `to_address` string, nullable — The email address to send the email to

## Response `201`

OK

- object
  - `email_template` EmailTemplateSchema
    - `cc_address` string, nullable — The email address to CC
    - `heron_id` string — Unique identifier for the email template
    - `html_body` string, required — The body of the email to send.
    - `name` string, required — Unique name of the email template. Used to match which email template to send. Only alphanumeric characters, underscores, and dashes are allowed.
    - `reply_to_address` string, nullable — The email address to reply to
    - `to_address` string, nullable — The email address to send the email to

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/herondata/heron-data-api/revisions/f2e441edece2/schema)