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

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!