Email Inboxes

Email inbox management (JWT or API key authentication)

📄️List email inboxes

Returns a list of email inboxes for the organization. Requires API key with `email_inboxes:read` scope.

📄️Create an email inbox

Claims a new email address and returns the inbox. The address must be on a domain this account can receive at, and is immutable once created. Requires API key with `email_inboxes:create` scope. The inbox is always created in the organization the key is bound to — there is no way to name a different one.

📄️Get an email inbox

Returns a single email inbox by id, scoped to the organization the API key is bound to. Requires API key with `email_inboxes:read` scope.

📄️Rename an email inbox

Updates an inbox display name. The address is immutable and is not part of this request. Requires API key with `email_inboxes:update` scope.

📄️Delete an email inbox

Soft-deletes the inbox and its messages in one transaction. The rows are retained and every read filters them out, so the data is recoverable — but the **address is retired permanently and can never be claimed again, by anyone including you**. Mail keeps being delivered to it, so releasing it would hand the next claimant your still-arriving messages. Requires API key with `email_inboxes:delete` scope, which is granted separately from create and update for exactly this reason.

📄️Get messages from an email inbox

Returns messages for a specific email inbox with optional pagination and filtering. Requires API key with `email_messages:read` scope.

📄️Get a single message

Returns a specific message from an email inbox. Requires API key with `email_messages:read` scope.

📄️Get the latest one-time code for an inbox

Returns the most recently extracted one-time passcode (OTP) for an email inbox, with the message it came from. Requires API key with `email_messages:read` scope — this is a read of extracted message content, not inbox metadata. Shares its lookup and arguments with the pibx_email_get_latest_otp MCP tool.