Terminal
Terminal/Skill
Command-line access to the Bird API for sending or previewing messages, managing API resources, and setting up an account.
By Bird
Works with
npx skills add messagebird/bird-ai --skill bird-clibird is a single binary for the Bird API and local tools such as WhatsApp message previews. Account operations need credentials; local previews do not.
If bird isn't installed (command -v bird finds nothing), install it first — a checksum-verified download to ~/.local/bin (or /usr/local/bin):
curl -fsSL https://cli.bird.com/install.sh | sh
Step 0 — Authenticate for account operations. For a WhatsApp preview, go directly to Preview; for public documentation questions, use docs. For account operations, confirm credentials first: authenticate. It is a no-op when bird auth status already reports valid: true. No account yet? Create one through onboarding; it ends by storing the same credential a login would.
Step 1 — Run the operation the user asked for:
bird email, including send-batch) → emailbird email templates) → email-templatesbird email broadcasts) → email-broadcastsbird sms) → smsbird sms tfn verifications) → tfn-verificationsbird sms senders) → sms-sendersbird amb) → Apple Messagesbird whatsapp preview) → Preview (local — skips Step 0)bird whatsapp) → WhatsApp operationsbird whatsapp templates) → whatsapp-templatesbird whatsapp groups) → whatsapp-groupsbird whatsapp agents) → whatsapp-agentsbird voice) → voicebird realtime) → realtimebird verify verifications) → verifybird lookup) → lookupbird contacts, bird audiences, bird contact-properties) → contactsbird preferences) → preferencesbird email domains), or find a verified from to send from → domainsbird email stats inbound) → received-mail-statsbird email inbox-insights) → inbox-insightsbird email competitive) → competitivebird email unsubscribe-page) → unsubscribe-pagebird email dedicated-ips) and IP pools (bird email ip-pools) (sending reputation) → ip-poolsbird email inbound-addresses), or read the mail received there (bird email inbound-messages) → inboundbird api-keys create, bird api-keys rotate) → api-keys (needs a login carrying api_keys:write; an API key cannot run it)bird trust) → trustbrands create can name it (bird compliance identities list) → compliance-identitiesbird sms 10dlc brands create, bird sms 10dlc brands submissions create) → sibling operations; node not yet authored, --help on each carries the field listbird config show (sibling operation; node not yet authored)Pick the operation that matches the request. Complete Step 0 only for operations that require an account.
These hold across operations, so the nodes rely on them instead of repeating them:
--format json). Single-record commands (get, status, show) also take --format text for a human-readable card. List commands ignore --format text and always emit JSON, so a script can pipe them through jq without a per-command branch.2 invalid usage or input, 3 not found, 4 auth or permission denied, 5 conflict, 6 transient (rate limit or server error, retry after retry_after), 7 a check ran and found a problem (check_failed), 1 anything else. Errors print to stderr; data to stdout.retryable has already been through that — re-running it immediately rarely helps. --max-retries 0 turns it off when you drive your own retry loop.bird auth login is bound to one workspace and its region, which picks the API host; override with --base-url/BIRD_API_URL. Details and the state check live in authenticate.