---
title: "Send a message"
method: POST
path: "/v1/inboxes/{id}/send"
tags: ["Messages"]
---

# Send a message

`POST /v1/inboxes/{id}/send`

## Request

- Base URL: `https://anjal.app`
- URL: `https://anjal.app/v1/inboxes/{id}/send`
- Auth: API key in header `X-API-Key`

Sends from this inbox. The `From` header is derived from the inbox's primary alias. Pass `verified: true` when you've validated the recipient domain out-of-band (e.g. via verify-email); otherwise, sends to an address that has never replied to this inbox are rejected as a deliverability safeguard.

Pass an `Idempotency-Key` header so a retry never sends twice. `labels` tags the sent message; `trackOpens: true` adds an open-tracking pixel to the HTML body. The `message.sent` webhook payload includes `labels`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `to` union, required
    - string, email
    - string[]
  - `cc` union: Cc recipient(s) — subject to the same MX + verified + abuse gates as `to`.
    - string, email
    - string[]
  - `bcc` union: Bcc recipient(s).
    - string, email
    - string[]
  - `subject` string, required
  - `plainBody` string
  - `htmlBody` string
  - `replyTo` string, email
  - `verified` boolean
  - `labels` union: Labels as an array or a comma-separated string. Stored lowercase and deduplicated; at most 32 labels of at most 64 characters, no commas.
    - string[]
    - string
  - `trackOpens` boolean: Add an open-tracking pixel (HTML body only). See `SendExtras`.

## Response `200`

Sent

- object
  - `id` string, uuid
  - `threadId` string, uuid
  - `status` string
  - `messageId` string

## Other responses

- `400`: Validation error, or IDEMPOTENCY_KEY_INVALID
- `403`: Inbox paused or plan limit reached
- `409`: `IDEMPOTENCY_KEY_REUSED` (the key was used for a different request) or `IDEMPOTENCY_IN_PROGRESS` (the first request with this key is still running).
- `502`: SMTP relay error

---

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