---
title: "Open Inbox"
method: POST
path: "/v1/teams/{team_id}/inboxes"
tags: ["inboxes"]
---

# Open Inbox

`POST /v1/teams/{team_id}/inboxes`

Take a domain this team owns all the way to a live address.

One call covers claiming the domain for mail, writing the verification
records into the zone Stormy controls, and opening the address. It returns
the same receipt whether it finished or stopped — with the exact blocker
when it stopped, never a half-answer that reads like success.

## Path parameters

- `team_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Request body

- OpenInboxRequest — One address on a domain this team already owns.
  - `domain` string, required
  - `username` string, required
  - `display_name` string, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/52151384d62a?raw)