Templates

List Templates

Retrieve a paginated list of email templates for a project. If project_id is not provided, templates from the team's default project will be returned.

get/templates

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/templates
  • Auth: HTTP bearer

Query parameters

project_idinteger

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

folder_idinteger
Example:10

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".

purpose'transactional' | 'campaign'
Example:campaign

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

per_pageinteger

Number of results per page (1-100)

pageinteger

Page number

Response

List of templates retrieved successfully

messagestring required

Human-readable response message

Example response

{
  "message": "Templates retrieved successfully.",
  "data": {
    "templates": [
      {
        "id": 1,
        "name": "Welcome Email",
        "slug": "welcome-email",
        "project_id": 5,
        "folder_id": 10,
        "purpose": "campaign",
        "preparation_status": "ready",
        "created_at": "2025-01-15T10:00:00+00:00",
        "updated_at": "2025-01-20T14:30:00+00:00"
      }
    ],
    "pagination": {
      "total": 42,
      "per_page": 25,
      "current_page": 1,
      "last_page": 2
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.