Documentation
Sign inGet started

bird email mailboxes

Usage

Code example
bird email mailboxes

Description

Create and manage agent email mailboxes — the shared inboxes your AI agents and support workflows read from. A mailbox has an address, a receive policy that controls which messages it accepts, a retention tier, and labels for categorising threads.
Use compose to send an outbound message from a mailbox. Use receive-rules to filter inbound senders. Use threads and thread messages (under email threads) to read and reply to conversations in a mailbox.
Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

Commands

NameDescription
composeSend a new message from a mailbox
createCreate a mailbox
deleteDelete a mailbox
getGet a mailbox
labelsList a mailbox's labels
listList mailboxes
receive-rulesManage a mailbox's receive rules
restoreRestore a deleted mailbox
resumeResume a suspended mailbox
statsMailbox email statistics
updateUpdate a mailbox