Templates
List Folders
Retrieve a paginated list of the folders in a project, so a template can be filed into the right one.
Folder IDs are what folder_id on POST /templates expects. Folders belong to a module: a transactional folder holds the templates you send single emails with, a campaign folder holds the ones the campaign builder can pick. A template's folder must belong to the same module as its purpose.
get/folders
Request
- Base URL: https://app.lettr.com/api
- URL: https://app.lettr.com/api/folders
- Auth: HTTP bearer
Query parameters
project_idinteger
Project ID to retrieve folders from. If not provided, uses the team's default project.
purpose'transactional' | 'campaign'
Example:campaign
Return only the folders of one module. If not provided, folders of both modules are returned.
per_pageinteger
Number of results per page (1-100)
pageinteger
Page number
Response
Folders retrieved successfully
Example response
{
"message": "Folders retrieved successfully.",
"data": {
"folders": [
{
"id": 10,
"name": "Campaigns",
"project_id": 5,
"purpose": "campaign",
"templates_count": 12,
"created_at": "2025-01-15T10:00:00+00:00",
"updated_at": "2025-01-20T14:30:00+00:00"
}
],
"pagination": {
"total": 2,
"per_page": 25,
"current_page": 1,
"last_page": 1
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.