List Transactional Emails API

List the active transactional email definitions available to an organization API key.

List the active transactional email definitions available to your application. A definition binds a stable slug to an email template managed in Growth.

Request

GET /api/v1/email/transactional

Send the organization API key with x-api-key or Authorization: Bearer.

curl -H "x-api-key: YOUR_API_KEY" \
  https://your-growth-app.convex.site/api/v1/email/transactional

Response

A successful request returns only active definitions:

{
  "transactionals": [
    {
      "id": "…",
      "slug": "freebie-kit",
      "name": "Freebie kit",
      "description": "Sent when someone requests the kit"
    }
  ]
}

Use the returned slug as transactional when calling the send endpoint. The template remains live: edits made in Growth apply to subsequent sends.

Errors

Status	Meaning
`401`	The API key is missing or invalid.

Trigger Event Get Email Contact API