Skip to main content
GET
List Folders
Lists the folders templates are filed into, with each folder’s mode and how many templates it holds. This is the only endpoint that returns folder IDs. Without it, folder_id on Create Template can only be omitted — letting the API pick a folder — or guessed from an integer read out of an app URL.

Modes

Folders are mode-scoped, matching the transactional / marketing split. Filter with purpose to get just one side:
A template’s folder_id must name a folder of the same mode as its purpose. Create Template rejects a folder of the other mode with 422, and when you leave folder_id out, the template goes to the main folder of its mode. You can also pass folder_id to List Templates to list only the templates in one folder.

Read-only

Folders are created and managed in the app. There is no API to create, rename or delete one, because deleting a folder moves or deletes the templates inside it.

Authorizations

Authorization
string
header
required

API key for authentication

Query Parameters

project_id
integer

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

Required range: x >= 1
purpose
enum<string>

Return only the folders of one module. If not provided, folders 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

Folders retrieved successfully

Response containing a paginated list of folders

message
string
required

Human-readable response message

Example:

"Folders retrieved successfully."

data
object
required