---
title: "Create a mail inbox"
method: POST
path: "/mail/v1/inboxes"
tags: ["Agents"]
---

# Create a mail inbox

`POST /mail/v1/inboxes`

Create an inbox owned by the authenticated organization.

## Request body

- object
  - `address` string
  - `displayName` string

## Response `201`

Inbox created successfully

## Other responses

- `401` — Invalid API key
- `403` — Write access required
- `503` — Mail provider is not configured

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)