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

# Create inbox

`POST /v1/inbox`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/inbox`
- Auth: HTTP bearer

Create (claim) an `@agentlair.dev` inbox. Provide a `name` for a human-readable address
or omit for a random slug.

## Request body

- object
  - `name` string: Local part of the address (e.g., "alice" → alice@agentlair.dev)

## Response `201`

Inbox created

- object
  - `address` string
  - `created` boolean
  - `already_owned` boolean
  - `account_id` string

## Other responses

- `409`: Address taken by another account

---

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