---
title: "Create an email template"
method: POST
path: "/smtp/templates"
tags: ["Transactional emails"]
---

# Create an email template

`POST /smtp/templates`

## Request body

- CreateSmtpTemplate
  - `tag` string — Tag of the template
  - `sender` CreateSmtpTemplateSender, required — Sender details including id or email and name (optional). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For example `{"name":"xyz", "email":"example@abc.com"}` , `{"name":"xyz", "id":123}`
    - `name` string — Name of the sender. If not passed, will be set to default
    - `email` string, email — Email of the sender
    - `id` integer — Select the sender for the template on the basis of sender id. In order to select a sender with specific pool of IP’s, dedicated ip users shall pass id (instead of email).
  - `templateName` string, required — Name of the template
  - `htmlContent` string — Body of the message (HTML version). The field must have more than 10 characters. REQUIRED if htmlUrl is empty
  - `htmlUrl` string, url — Url which contents the body of the email message. REQUIRED if htmlContent is empty
  - `subject` string, required — Subject of the template
  - `replyTo` string, email — Email on which campaign recipients will be able to reply to
  - `toField` string — To personalize the «To» Field. If you want to include the first name and last name of your recipient, add {FNAME} {LNAME}. These contact attributes must already exist in your Brevo account. If input parameter 'params' used please use {{contact.FNAME}} {{contact.LNAME}} for personalization
  - `attachmentUrl` string, url — Absolute url of the attachment (no local file). Extension allowed: xlsx, xls, ods, docx, docm, doc, csv, pdf, txt, gif, jpg, jpeg, png, tif, tiff, rtf, bmp, cgm, css, shtml, html, htm, zip, xml, ppt, pptx, tar, ez, ics, mobi, msg, pub and eps
  - `isActive` boolean — Status of template. isActive = true means template is active and isActive = false means template is inactive

## Response `201`

transactional email template created

- CreateModel
  - `id` integer, required — ID of the object created

## Other responses

- `400` — bad request

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/versions/2aec3cf66501/schema)