bird-cli

Bird CLI

bird is a single binary that talks to the Bird API. Each top-level command is one operation; every operation talks to the live API, so all of them need credentials first.

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

The path

Step 0 — Authenticate (shared prerequisite). Every command below fails without a key, and the failure looks the same as a real error, so confirm credentials first: authenticate. It is a no-op when bird auth status already reports valid: true, so it is safe to run first every time. No account yet? Create one — account, organization, and workspace — from scratch: onboarding; it ends by storing the same credential a login would.

Step 1 — Run the operation the user asked for:

• Send or inspect email messages (bird email, including send-batch) → email
• Author reusable email templates, submit a draft, or roll one back (bird email templates) → email-templates
• Send or inspect SMS messages, or browse SMS templates (bird sms) → sms
• Draft the carrier verification a US toll-free number needs before it can send, read what the carrier asks for, or see why one was declined (bird sms tfn verifications) → tfn-verifications
• Claim an alphanumeric SMS sender, find out what a country requires of it, or register it for a country (bird sms senders) → sms-senders
• Send or inspect WhatsApp messages, follow a message's events, connect or manage the numbers and business accounts the workspace sends from, check whether WhatsApp will accept a number before buying it, or read WhatsApp traffic statistics (bird whatsapp) → whatsapp
• Browse WhatsApp templates, their versions, and each version's per-language content (bird whatsapp templates) → whatsapp-templates
• Inspect voice calls, find out why one was refused, configure a SIP trunk or an inbound number, enable or disable calling to a country, or place a test call (bird voice) → voice
• Provision Realtime apps and rotate the keys their clients connect with (bird realtime) → realtime
• Verify a recipient with a one-time passcode — send a code, then check what they submit (bird verify verifications) → verify
• Find out about a recipient before you use it — grade an email address, or identify a phone number and its network (bird lookup) → lookup
• Manage contacts, audiences, and contact properties (bird contacts, bird audiences, bird contact-properties) → contacts
• Record and look up messaging consent grants and opt-outs (bird preferences) → preferences
• Manage sending domains (bird email domains), or find a verified from to send from → domains
• Count how much mail the workspace received, by period, day or hour (bird email stats inbound) → received-mail-stats
• Style the hosted page a marketing recipient lands on when they unsubscribe (bird email unsubscribe-page) → unsubscribe-page
• Manage dedicated IPs (bird email dedicated-ips) and IP pools (bird email ip-pools) (sending reputation) → ip-pools
• Receive email at inbound forward addresses (bird email inbound-addresses), or read the mail received there (bird email inbound-messages) → inbound
• Manage outbound webhook endpoints → webhooks
• Issue a workspace API key (bird api-keys create) → api-keys (needs a login carrying api_keys:write; an API key cannot run it)
• Find out why acquiring a number or registering a sender was refused for a reason about the organization rather than the country, and settle the requirement behind it (bird trust) → trust
• Find the business a 10DLC brand is registered for, so brands create can name it (bird compliance identities list) → compliance-identities
• Register a 10DLC brand for US A2P traffic, or file a submission against one (bird sms 10dlc brands create, bird sms 10dlc brands submissions create) → sibling operations; node not yet authored, --help on each carries the field list
• Open a support ticket, reply to it, or wait for a support agent reply → support
• Answer a how-to or reference question about Bird from the documentation → docs (public — skips Step 0)
• Inspect resolved CLI configuration → bird config show (sibling operation; node not yet authored)