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

# Create an inbox

`POST /inboxes`

## Request

- Base URL: `https://api.blinkinbox.club/api/v1`
- URL: `https://api.blinkinbox.club/api/v1/inboxes`
- Auth: HTTP bearer

## Request body

- object
  - `prefix` string: Address starts with this, followed by 8 random characters.
  - `localPart` string: Exact local part. Custom domains, or Pro on the shared domain.
  - `domain` string: A verified custom domain. Defaults to the shared domain.
  - `ttlMinutes` integer: Lifetime; max depends on plan.
  - `label` string

## Response `201`

Created

- Inbox
  - `id` string
  - `address` string
  - `localPart` string
  - `domain` string
  - `label` string
  - `source` 'web' | 'api' | 'mcp'
  - `active` boolean
  - `createdAt` string, date-time
  - `expiresAt` string, date-time

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Rate limit or quota exceeded

---

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