Skip to main content
GET
List Templates
Returns a paginated list of templates for your team. Narrow the list with these query parameters:
  • project_id — only templates in one project
  • purpose — transactional or campaign, to list one mode
  • folder_id — only templates in one folder; get folder IDs from List Folders. A folder outside the project returns 404.
Each template in the list includes its name, slug, project and folder assignment, and timestamps. To retrieve the full HTML content and version details for a specific template, use Get Template.

Authorizations

Authorization
string
header
required

API key for authentication

Query Parameters

project_id
integer

Project ID to retrieve templates from. If not provided, uses the team's default project.

Required range: x >= 1
folder_id
integer

Return only the templates in one folder of the resolved project. Discover folder ids with GET /folders. A folder that does not exist in that project answers 404 rather than an empty list, so a typo cannot be mistaken for "nothing is there yet".

Required range: x >= 1
Example:

10

purpose
enum<string>

Return only the templates of one module. If not provided, templates of both modules are returned.

Available options:
transactional,
campaign
Example:

"campaign"

per_page
integer
default:25

Number of results per page (1-100)

Required range: 1 <= x <= 100
page
integer
default:1

Page number

Required range: x >= 1

Response

List of templates retrieved successfully

Response containing a paginated list of templates

message
string
required

Human-readable response message

Example:

"Templates retrieved successfully."

data
object
required