Create Email Template (V2) - MoEngage

curl --request POST \
  --url https://api-{dc}.moengage.com/v1.0/custom-templates/email \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "basic_details": {
    "subject": "Email_Subject",
    "email_content": "<!DOCTYPE html><html><head><title>My Short HTML</title></head><body><h1>Hello, World!</h1><p>This is a simple HTML example.</p></body></html>",
    "thumbnail_url": "{{template_thumbnail_thumbnail_url}}",
    "sender_name": "Sender_Name",
    "preview_text": "Preview_text",
    "attachments": []
  },
  "meta_info": {
    "created_by": "john.doe@example.com",
    "template_id": "{{template_id_1}}",
    "template_name": "{{template_name}}",
    "template_version": "{{template_version}}",
    "locale": "{{Locale_name}}",
    "variation": 1
  }
}
'

{
  "external_template_id": "d05a44f0-a7cf-471a-bcb6-63054800a367"
}

POST

/

custom-templates

/

email

curl --request POST \
  --url https://api-{dc}.moengage.com/v1.0/custom-templates/email \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "basic_details": {
    "subject": "Email_Subject",
    "email_content": "<!DOCTYPE html><html><head><title>My Short HTML</title></head><body><h1>Hello, World!</h1><p>This is a simple HTML example.</p></body></html>",
    "thumbnail_url": "{{template_thumbnail_thumbnail_url}}",
    "sender_name": "Sender_Name",
    "preview_text": "Preview_text",
    "attachments": []
  },
  "meta_info": {
    "created_by": "john.doe@example.com",
    "template_id": "{{template_id_1}}",
    "template_name": "{{template_name}}",
    "template_version": "{{template_version}}",
    "locale": "{{Locale_name}}",
    "variation": 1
  }
}
'

{
  "external_template_id": "d05a44f0-a7cf-471a-bcb6-63054800a367"
}

Rate Limit

The rate limit is 100 RPM. You can upload a maximum of 10000 templates per channel.

Authorizations

Authorization

string

header

required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
Password: Use your API Key, which you can find within the Data tile.

For more information on authentication and getting your credentials, refer here.

Body

application/json

basic_details

object

required

Show child attributes

meta_info

object

required

Show child attributes

Response

This response is returned when the request is processed successfully.

external_template_id

string

This field contains the unique template id corresponding to a successful template creation request and needs to be stored by you. This template id would be used for searching a specific template and updating it. For a parent (default) template, the generated "external_template_id" acts as its group ID.

Email Templates (V2) Overview Search Email Template

⌘I