Skip to main content
POST
Create or return an inbox

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Headers

Idempotency-Key
string

Optional idempotency key for safe retries of side-effecting operations.

Maximum string length: 128

Body

application/json
username
string
required
Example:

"billing"

domain
string
required
Example:

"orin-ai.app"

localPart
string
deprecated
agent
string
default:Inbox Agent
mode
enum<string>
default:receive_send
Available options:
receive_send,
send_only,
receive_only

Response

Success

inbox
object
required