---
title: "Create an inbox"
method: POST
path: "/v1/inboxes"
tags: ["Inboxes"]
---

# Create an inbox

`POST /v1/inboxes`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/inboxes`
- Auth: HTTP bearer

Organise one address on your own domain as an inbox with threads, labels, folders and drafts. The domain must have receiving turned on and be able to send (mail from the inbox is sent from its address): verified for sending, or a receiving subdomain of a verified domain. SMTPfast never provisions addresses on a shared domain, so forwarding: true is refused and receiving_address is always null. Mail the address already received in the last 30 days is filed into threads. Requires the domain:write scope on a key created by a team owner or admin.

## Request body

- object
  - `email_address` string, email, required: A plain address on one of your domains, such as support@example.com
  - `name` string: Internal name. Defaults to email_address.
  - `from_name` string: The name recipients see. A plain name, not a Name <email> address.
  - `forwarding` boolean: Not available: must be false or omitted. Inboxes receive through your domain's MX record.

## Response `201`

The new inbox

- Inbox
  - `object` string
  - `id` string
  - `name` string
  - `email_address` string
  - `domain_id` string
  - `receiving_address` unknown
  - `from_name` string, nullable
  - `unread` integer: Threads in the inbox folder with at least one unread message
  - `drafts` integer: Unsent drafts
  - `last_received` string, date-time, nullable: When a thread in this inbox was last active
  - `created_at` string, date-time

## Other responses

- `400`: Bad request - check your payload
- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `409`: Conflict - the resource already exists or changed meanwhile
- `422`: The request is well formed but cannot be carried out in the current state, for example an unpublished template
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

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