---
title: "Send a transactional email"
method: POST
path: "/api/v1/send"
tags: ["Send"]
---

# Send a transactional email

`POST /api/v1/send`

## Request

- Base URL: `https://justemails.app`
- URL: `https://justemails.app/api/v1/send`
- Auth: HTTP bearer

## Request body

- SendTransactionalRequest
  - `from` string, email, required: Sender address on a verified domain.
  - `to` union, required
    - string, email
    - string[]
  - `cc` union
    - string, email
    - string[]
  - `bcc` union
    - string, email
    - string[]
  - `subject` string, required
  - `html` string
  - `text` string
  - `replyTo` string, email
  - `idempotencyKey` string
  - `trackOpens` boolean: Open tracking for this send (1x1 image in the HTML part). Omit for the account default, which is off. Approximate: Apple Mail Privacy Protection and image proxies load images without a reader.
  - `trackClicks` boolean: Click tracking for this send (HTML links rewritten to a signed justemails.app redirect; plain text untouched). Omit for the account default, which is off.
  - `tags` string[]
  - `headers` object

## Response `200`

Enqueued for delivery

- object
  - `data` object, required
    - `id` string
  - `meta` object

## Other responses

- `429`: Rate limited

---

[API](https://skmtc.dev/justemails/apis/justemails-api.md) · [All operations](https://skmtc.dev/justemails/apis/justemails-api/llms.txt) · [OpenAPI document](https://skmtc.dev/justemails/apis/justemails-api/revisions/3bd7e6b390c5?raw)