List available email templates
get
/templates/email/list
Use this endpoint to get a list of available templates in your Braze account.
Use the Template REST APIs to programmatically manage the email templates that you have stored on the Braze dashboard, on the Templates & Media page. Braze provides two endpoints for creating and updating your email templates.
Rate limit
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
Request parameters
Parameter | Required | Data Type | Description |
---|---|---|---|
modified_after |
Optional | String in ISO-8601 format | Retrieve only templates updated at or after the given time. |
modified_before |
Optional | String in ISO-8601 format | Retrieve only templates updated at or before the given time. |
limit |
Optional | Positive Number | Maximum number of templates to retrieve. Default to 100 if not provided, with a maximum acceptable value of 1000. |
offset |
Optional | Positive Number | Number of templates to skip before returning rest of the templates that fit the search criteria. |
Example request
1
2
curl --location --request GET 'https://rest.iad-01.braze.com/templates/email/list?modified_after=2020-01-01T01:01:01.000000&modified_before=2020-02-01T01:01:01.000000&limit=1&offset=0' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Response
important:
Templates built using the Drag & Drop Editor are not provided in this response.
1
2
3
4
5
6
7
8
9
10
11
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"count": number of templates returned
"templates": [template with the following properties]:
"email_template_id": (string) your email template's API Identifier,
"template_name": (string) the name of your email template,
"created_at": (string, in ISO 8601),
"updated_at": (string, in ISO 8601),
"tags": (array of strings) tags appended to the template
}