Sign in

List email templates

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the app's email templates, newest first, without their HTML. Get a template's HTML with Get email template.

An app's email templates are files in its code, in base44/emails/. The AI creates and edits them through Send chat message.

You get up to limit templates, at most 200, and there's no pagination.

This is limited to 60 requests per minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit. Get email stats shares it.

<Note>This endpoint accepts a personal API key belonging to a user with access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/apps/{app_id}/emails

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/emails
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app the emails belong to.

Query parameters

limitinteger

Maximum number of templates to return, from 1 to 200. Defaults to 30.

Response

The app's email templates, newest first.

idstring required

ID of the template.

app_idstring required

ID of the app the template belongs to.

namestring required

Name of the template, from its file name: the template in base44/emails/Welcome.html is Welcome. A workflow's send email action or a backend function's SendEmail call picks the template by this name.

created_datestring date-time required

When the template was created, as a UTC timestamp in ISO 8601 format.

updated_datestring date-time required

When the template last changed, as a UTC timestamp in ISO 8601 format.

Example response

[
  {
    "id": "68c1f0a2b3d4e5f6a7b8c9d0",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "name": "Welcome",
    "created_date": "2026-09-14T08:30:12.418000Z",
    "updated_date": "2026-09-14T08:30:12.418000Z"
  }
]

Changes