bird email mailboxes compose
Usage
Przykład kodu
bird email mailboxes compose <mailbox-id> [flags]Description
Send a new message from a mailbox
Sends from the mailbox's own address and starts a new conversation. Replies thread back into it automatically. To reply within an existing conversation, use bird email threads messages reply instead. An unset --reply-to, --category, --tag or --metadata falls back to the "email" defaults in the CLI config file; the sender and delivery defaults do not apply, because a compose sends as the mailbox.
Build the request from flags, a JSON EmailMailboxComposeRequest 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
Przykład kodu
# print the body shape (no credentials needed)
bird email mailboxes compose --example
# the body it prints:Przykład kodu
{
"subject": "Your quote",
"text": "Hi, here is the quote you asked for.",
"to": ["delivered@messagebird.dev"]
}Przykład kodu
# preview the resolved request without sending
bird email mailboxes compose <mailbox-id> --to alice@example.com --subject "Hi" --text "Hello" --dry-runOptions
Recipients
| Name | Description |
|---|---|
| --to <value>… | Recipient address; repeatable. Accepts bare addresses or RFC 5322 "Name <addr>" form |
| --cc <value>… | CC recipient; repeatable. Accepts bare addresses or RFC 5322 "Name <addr>" form |
| --bcc <value>… | BCC recipient; repeatable. Accepts bare addresses or RFC 5322 "Name <addr>" form |
| --reply-to <value>… | Reply-To address; repeatable. Defaults to the mailbox's own default-reply-to |
Content
| Name | Description |
|---|---|
| --subject | Subject line |
| --html | HTML body |
| --text | Plain-text body |
Labels & metadata
| Name | Description |
|---|---|
| --tag <key=value> | Tag as name=value; repeatable |
| --metadata | Arbitrary JSON metadata object |
Delivery
| Name | Description |
|---|---|
| --category | Suppression policy: marketing or transactional; defaults to transactional |
Request
| Name | Description |
|---|---|
| --body-file | Read the JSON request body from this file; "-" reads stdin |
| --example | Print a complete example request body, then exit |
| --dry-run | Print the resolved request without sending it, then exit |
| --idempotency-key | Deduplication key; a retry with the same key won't act twice |
Options
| Name | Description |
|---|---|
| --response-schema | Print the fields this command returns, then exit |
Related
| Name | Description |
|---|---|
| bird email mailboxes create | Create a mailbox |
| bird email mailboxes delete | Delete a mailbox |
| bird email mailboxes get | Get a mailbox |
| bird email mailboxes labels | List a mailbox's labels |
| bird email mailboxes list | List mailboxes |
| bird email mailboxes restore | Restore a deleted mailbox |
| bird email mailboxes resume | Resume a suspended mailbox |
| bird email mailboxes stats | Get mailbox email statistics |
| bird email mailboxes update | Update a mailbox |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikSetting up your coding agentZrozum koncepcjęWhat is an MCP server, and how does an agent use one to send messages?Poznaj możliwościCoding agentsPodążaj ścieżką naukiBuild with AI agents
Uzyskaj brief wdrożeniowy