> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Send email template test

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



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/emails/{template_id}/test
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/emails/{template_id}/test:
    post:
      summary: Send email template test
      description: >-
        <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>
      operationId: send_test_email_to_self_api_apps__app_id__emails__template_id__test_post
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app the emails belong to.
            title: App Id
          description: ID of the app the emails belong to.
          example: 6820f3a4e7b91d003c45a1f2
        - name: template_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the email template to send. Get it from `id` in [List email
              templates](/api-reference/list-email-templates).
            title: Template Id
          description: >-
            ID of the email template to send. Get it from `id` in [List email
            templates](/api-reference/list-email-templates).
          example: 68c1f0a2b3d4e5f6a7b8c9d0
      responses:
        '200':
          description: The test was sent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestEmailSent'
        '400':
          description: The user your credential belongs to has no email address.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            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':
          description: App not found, or the app has no email template with this ID.
        '429':
          description: >-
            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.
components:
  schemas:
    TestEmailSent:
      properties:
        sent_to:
          type: string
          title: Sent To
          description: >-
            The address the test went to: the email address of the user the
            credential belongs to.
          example: dana@acme.com
      type: object
      required:
        - sent_to
      title: TestEmailSent
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.