Skip to content

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.

See me in Postman

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

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
}
  Edit this page on GitHub
WAS THIS PAGE HELPFUL?
New Stuff!