---
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

## Changes

- **2026-03-16** `20c3468a7d4a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/casemark/apis/case-dev-api/changes/mail/v1/inboxes/post.md)

---

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