---
title: "Post New Template API"
method: POST
path: "/v1/{sID}/email/templates/"
tags: ["Email Templates"]
---

# Post New Template API

`POST /v1/{sID}/email/templates/`

## Request

- Base URL: `https://{{url}}`
- URL: `https://{{url}}/v1/{sID}/email/templates/`
- Auth: none declared

You can use templates in email APIs to send standard/uniform email messages to customers. By default, the email APIs must be sent only with an approved template.

In order to get a new email template approved, contact your Kaleyra account manager or reach out to the Kaleyra [support](https://developers.kaleyra.io/docs/support) team. A template is approved based on its relevance to the brand details of the product.

You cannot send an email without a template by default. To enable the email service without a template, contact your Kaleyra account manager or reach out to the Kaleyra [support](https://developers.kaleyra.io/docs/support) team.

In the email templates, you can specify the values for the parameters, 'from', 'subject', html_body, text_body, and template_name. The parameter values that you provide in the email API call take precedence(override) over the corresponding parameters in the email template.

While using a template in the email API, you must provide the template_id. Make sure to note down the template_id to be able to use in an email API.

## Path parameters

- `sID` string, required

## Headers

- `api-key` string
- `cache-control` string
- `Content-Type` string
- `Accept` string

## Request body `*/*`

- string

## Response `200`

OK

- object

---

[API](https://skmtc.dev/kaleyra/apis/email-rest-api-v1.md) - [All operations](https://skmtc.dev/kaleyra/apis/email-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/kaleyra/apis/email-rest-api-v1/revisions/1bcf8463d02d?raw)