Sign in

Get email template

Changed on

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

Returns one of the app's email templates with its HTML.

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

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.

<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/{template_id}

Request

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

Path parameters

app_idstring required

ID of the app the emails belong to.

template_idstring required

ID of the email template to get. Get it from id in List email templates.

Response

The email template.

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.

htmlstring required

The email as inbox-ready HTML. Its <title> is the default subject line. {{variable}} placeholders, such as {{first_name}}, stay as written. The sender fills them in.

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",
  "html": "<!doctype html><html><head><title>Welcome to Acme</title></head><body>Hi {{first_name}}</body></html>"
}

Changes