---
title: "Send email template test"
method: POST
path: "/api/apps/{app_id}/emails/{template_id}/test"
---

# Send email template test

`POST /api/apps/{app_id}/emails/{template_id}/test`

## Request

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

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

Sends you a test copy of an email template. The subject is the template's `<title>`, or its name when it has none, with `[Test]` in front. `{{variable}}` placeholders are sent as written.

The test goes only to the email address of the user your credential belongs to. You can't choose another recipient.

This is limited to 5 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 editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

## Path parameters

- `app_id` string, required: ID of the app the emails belong to.
- `template_id` string, required: ID of the email template to send. Get it from `id` in [List email templates](/api-reference/list-email-templates).

## Response `200`

The test was sent.

- TestEmailSent
  - `sent_to` string, required: The address the test went to: the email address of the user the credential belongs to.

## Other responses

- `400`: The user your credential belongs to has no email address.
- `401`: Missing or invalid credentials.
- `403`: You don't have editor access to this app, the app is blocked, your API key is read-only, or you used a workspace API key.
- `404`: App not found, or the app has no email template with this ID.
- `429`: Rate limit exceeded. The base limit is 5 requests per minute. See [Rate limits](/developers/references/apps-api/get-started/rate-limits) for the multiplier your plan gets.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-09** `fc604cdcc3a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/emails/:template_id/test/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)