Documentation
Sign inGet started

bird email mailboxes create

Usage

Ejemplo de código
bird email mailboxes create [flags]

Description

Create a mailbox
Claims an inbox.ai address, or an address on one of your own domains enabled for receiving. An inbox.ai address is permanently reserved to your organization even after the mailbox is deleted.
Build the request from flags, a JSON MailboxCreate body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Ejemplo de código
# print the body shape (no credentials needed)
bird email mailboxes create --example

# the body it prints:
Ejemplo de código
{
  "display_name": "Acme Concierge",
  "local_part": "concierge",
  "receive_policy": "open",
  "retention_tier": "30d"
}

Options

Address

NameDescription
--local-partLocal part of the address, before the @; omit to generate one
--domainDomain for the address; defaults to inbox.ai, the shared mailbox domain
--display-nameSender display name on outgoing mail
--default-reply-toDefault Reply-To address stamped on outgoing mail

Behavior

NameDescription
--receive-policyWhich inbound mail to accept: open, replies_only, allowlist, or drop
--retention-tierHow long to remember message metadata and text: 30d

Metadata

NameDescription
--metadataArbitrary JSON metadata object

Request

NameDescription
--body-fileRead the JSON request body from this file; "-" reads stdin
--examplePrint a complete example request body, then exit
--dry-runPrint the resolved request without sending it, then exit
--idempotency-keyDeduplication key; a retry with the same key won't act twice

Options

NameDescription
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird email mailboxes composeSend a new message from a mailbox
bird email mailboxes deleteDelete a mailbox
bird email mailboxes getGet a mailbox
bird email mailboxes labelsList a mailbox's labels
bird email mailboxes listList mailboxes
bird email mailboxes restoreRestore a deleted mailbox
bird email mailboxes resumeResume a suspended mailbox
bird email mailboxes statsMailbox email statistics
bird email mailboxes updateUpdate a mailbox