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

# Send an email

`POST /api/v1/send`

## Request

- Base URL: `https://mailinapp.com`
- URL: `https://mailinapp.com/api/v1/send`
- Auth: HTTP bearer

Freeform (`subject`, `html`, `text`) or template (`projectId` + `mergeData`, sends an existing studio project). Suppressed and invalid addresses are not sent to (`status: suppressed`).

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `to` string, email, required
  - `type` 'transactional' | 'marketing'
  - `subject` string
  - `html` string
  - `text` string
  - `projectId` string
  - `mergeData` object
  - `from` object
    - `email` string, email, required
    - `name` string
  - `senderId` string
  - `replyTo` string, email

## Response `200`

The send's outcome

- object
  - `id` string, required
  - `status` 'pending' | 'sent' | 'failed' | 'suppressed', required
  - `reason` string
  - `error` string

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `404`: Not found, or not this account's
- `429`: Too many requests for this key

---

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