---
title: "Create an inbox"
method: POST
path: "/inboxes"
---

# Create an inbox

`POST /inboxes`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/inboxes`
- Auth: HTTP bearer

On the shared relay, or on a domain this org has verified. The webhook secret is returned ONCE.

## Request body

- object
  - `username` string
  - `domain` string
  - `display_name` string
  - `autonomy` 'auto' | 'approve_first' | 'notify'
  - `callback_url` string

## Response `201`

Created

---

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