Overview
Email Template APIs enable marketers to define, reuse, update, and manage email templates created outside the MoEngage ecosystem with ease. The templates created and updated using these APIs are supported for the Custom HTML Editor (Froala Editor) and not the Drag and Drop Editor.Email Template API V1 Endpoints
- Create Email Template: Creates an email template.
- Update a Specific Email Template: Updates an email template specified by its template id.
- Bulk Create/Update Email Template: Creates and updates email templates in bulk.
- Get a Specific Email Template: Fetches an email template using its template id.
- Get all Email Templates: Fetches all the email templates in your MoEngage account.
Rate Limits
To ensure system stability, the following rate limits are applied per workspace:| Endpoint | Limit |
|---|---|
| Create Email Template | The rate limits are at the app level, and a maximum of a thousand (sum of all the API requests per app)requests are allowed for an app per minute. |
| Update a Specific Email Template | The rate limits are at the app level, and a maximum of a thousand (sum of all the API requests per app)requests are allowed for an app per minute. |
| Bulk Create/Update Email Template | The rate limits are at the app level, and a maximum of a thousand (sum of all the API requests per app)requests are allowed for an app per minute. |
| Get a Specific Email Template | The rate limits are at the app level, and a maximum of a thousand (sum of all the API requests per app)requests are allowed for an app per minute. |
| Get all Email Templates | The rate limits are at the app level, and a maximum of a thousand (sum of all the API requests per app)requests are allowed for an app per minute. |
FAQs
Create Email Template
How do I access templates created using this API on the MoEngage Dashboard?
How do I access templates created using this API on the MoEngage Dashboard?
You can access templates created using the Create Email Template API in the My Saved Templates tab during the second step of campaign creation in the MoEngage Dashboard, as illustrated in the image below:
Update a Specific Email Template
If I pass don't pass a few fields in the request and the created template has them already, will they be retained post the update?
If I pass don't pass a few fields in the request and the created template has them already, will they be retained post the update?
The update request will overwrite the existing template with the template shared in the update request. If the update request does not have some of the fields that the created template had, the updated template will not have them too. For example, if you do not pass any attachments in the update request, the updated template will not have any attachments, even if it had attachments while it was created.
Bulk Create/Update Email Template
How is the create request differentiated from an update template request?
How is the create request differentiated from an update template request?
In the case of an update, the template to be updated is identified using its template id. It is mandatory to pass the id field in the required for an update template request. Otherwise, it will be treated as a create template request.
Get a Specific Email Template
What happens when you search for a deleted template?
What happens when you search for a deleted template?
The error description contains the following message in such a case: “Template for given template id is archived”.