---
title: "Create a new Digital Template"
method: POST
path: "/digitalTemplates"
tags: ["9. Digital Templates"]
---

# Create a new Digital Template

`POST /digitalTemplates`

## Request body

- CreateEmailTemplateCriteria — <strong>name</strong> - A unique name to give the template.<br/><br/><strong>fromName</strong> - The name that will appear in the From line of the email and the {from_name} in the text message.<br/><br/><strong>subject</strong> - The Subject of the email.<br/><br/><strong>headerImage</strong> - A Base64 encoded string of an image that will show as the header of the email.<br/><br/><strong>headerImageAltText</strong> - The Alt Text for the Header Image in the email.<br/><br/><strong>accentColor</strong> - A Hex color value, six hexadecimal digits preceded by a pound sign, used as an accent in the email.<br/><br/><strong>messageBody</strong> - The message body for the email. This is often used to let the recipient know why they have received the reward.<br/><br/><strong>smsMessageBody</strong> - The message body for the SMS. This is often used to let the recipient know why they have received the reward. Must be non-NULL when sending rewards via SMS. (limited to 90 characters)<br/><br/><strong>closing</strong> - After the reward credential, a space to close the email message to the recipient.<br/><br/><strong>customerServiceMessage</strong> - If left null, Tango Card's Customer Support contact information will be included. Otherwise, please provide the contact information for your customer support if you are responsible for providing first-tier customer support to your recipients. (email only)<br/><br/><strong>accessControl</strong> - (Optional) Which Customers and/or Accounts should have access to this template.<br/><br/><strong>accessControl - type</strong> - The type of access being specified: PLATFORM, CUSTOMER or ACCOUNT.<br/><br/><strong>accessControl - identifier</strong> - Leave this field blank if the type is PLATFORM. Enter either the the customerIdentifier or the accountIdentifier if the type is CUSTOMER OR ACCOUNT, respectively.<br/><br/><strong>defaults</strong> - If you want this template to be used at order time for the given Platform, Customer or Account when the Email Template Identifier (etid) is not provided with the order.<br/><br/><strong>defaults - type</strong> - The type of default being specified: PLATFORM, CUSTOMER or ACCOUNT.<br/><br/><strong>defaults - identifier</strong> - Leave this field blank if the type is PLATFORM. Enter either the the customerIdentifier or the accountIdentifier if the type is CUSTOMER OR ACCOUNT, respectively.
  - `name` string, required — A unique name to give the template.
  - `fromName` string, required — The name that will appear in the From line of the email and the {from_name} in the text message.
  - `subject` string, required — The Subject of the email.
  - `headerImage` string, required — A Base64 encoded string of an image that will show as the header of the email.
  - `headerImageAltText` string, required — The Alt Text for the Header Image in the email.
  - `accentColor` string, required — A Hex color value, six hexadecimal digits preceded by a pound sign, used as an accent in the email.
  - `messageBody` string, required — The message body for the email. This is often used to let the recipient know why they have received the reward.
  - `smsMessageBody` string — The message body for the SMS. This is often used to let the recipient know why they have received the reward. Must be non-NULL when sending rewards via SMS. (limited to 90 characters)
  - `closing` string, required — After the reward credential, a space to close the email message to the recipient.
  - `customerServiceMessage` string — If left null, Tango Card's Customer Support contact information will be included. Otherwise, please provide the contact information for your customer support if you are responsible for providing first-tier customer support to your recipients. (email only)
  - `accessControl` StandardRewardEmailTemplateAccess[] — (Optional) Which Customers and/or Accounts should have access to this template.
    - `type` 'PLATFORM' | 'CUSTOMER' | 'ACCOUNT' — The type of access being specified: PLATFORM, CUSTOMER or ACCOUNT.
    - `identifier` string — Leave this field blank if the type is PLATFORM. Enter either the the customerIdentifier or the accountIdentifier if the type is CUSTOMER OR ACCOUNT, respectively.
  - `defaults` StandardRewardEmailTemplateDefault[] — If you want this template to be used at order time for the given Platform, Customer or Account when the Email Template Identifier (etid) is not provided with the order.
    - `type` 'PLATFORM' | 'CUSTOMER' | 'ACCOUNT' — The type of default being specified: PLATFORM, CUSTOMER or ACCOUNT.
    - `identifier` string — Leave this field blank if the type is PLATFORM. Enter either the the customerIdentifier or the accountIdentifier if the type is CUSTOMER OR ACCOUNT, respectively.

## Response `201`

Created

- EmailTemplateViewVerbose
  - `etid` string, required
  - `name` string, required
  - `fromName` string, required
  - `subject` string, required
  - `headerImage` string, required
  - `headerImageAltText` string, required
  - `accentColor` string, required
  - `messageBody` string, required
  - `smsMessageBody` string
  - `closing` string, required
  - `customerServiceMessage` string
  - `accessControls` StandardRewardEmailTemplateAccess[]
    - `type` 'PLATFORM' | 'CUSTOMER' | 'ACCOUNT' — The type of access being specified: PLATFORM, CUSTOMER or ACCOUNT.
    - `identifier` string — Leave this field blank if the type is PLATFORM. Enter either the the customerIdentifier or the accountIdentifier if the type is CUSTOMER OR ACCOUNT, respectively.
  - `defaults` StandardRewardEmailTemplateDefault[]
    - `type` 'PLATFORM' | 'CUSTOMER' | 'ACCOUNT' — The type of default being specified: PLATFORM, CUSTOMER or ACCOUNT.
    - `identifier` string — Leave this field blank if the type is PLATFORM. Enter either the the customerIdentifier or the accountIdentifier if the type is CUSTOMER OR ACCOUNT, respectively.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict; Duplicate Exists
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/tangocard/apis/tango-api.md) · [All operations](https://skmtc.net/tangocard/apis/tango-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tangocard/tango-api/revisions/324ad9683921/schema)