bird

Usage

Codevoorbeeld

bird

Description

Authenticate, configure, and operate the Bird API from the command line.

Output is JSON by default; pass --format text for a human-readable card on single-record reads (get, show). Errors and diagnostics go to stderr, never mixed with data on stdout.

Mutations (send, create, test) take input from flags, a JSON body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run a command with --example to print its body shape, --dry-run to preview the request without sending, and --idempotency-key to make a retry safe.

Run "bird commands" to print the whole command tree as JSON.

Channels

Name	Description
email	Send and receive email and manage its deliverability resources
sms	Send SMS and manage its messaging resources
whatsapp	Send WhatsApp messages and browse its template catalogue

Contacts & Audiences

Name	Description
contacts	Manage contacts
audiences	Manage audiences
contact-properties	Manage contact properties

Developer

Name	Description
webhooks	Manage outbound webhook endpoints
verify	Send one-time passcodes and check them
docs	Search the Bird documentation
request-logs	Inspect your API request logs

Account

Name	Description
auth	Manage Bird API credentials
billing	Inspect billing plans and pricing
support-tickets	Open and follow up on Bird support tickets
members	Manage workspace members
invitations	Manage workspace invitations
organization	Manage the organization: members, invitations, and workspaces
workspace	Inspect the current workspace and its settings

CLI

Name	Description
config	Inspect CLI configuration
version	Print the CLI version
update	Update the bird CLI to the latest release
commands	Print the full command tree as JSON
mcp	Serve Bird as MCP tools over stdio
whoami	Show the signed-in user (id, email, name)

Examples

Codevoorbeeld

# Sign in (opens a browser)
bird auth login

# Send an email from a JSON body
bird email send --body-file message.json

# List recent messages and pull their ids
bird email list | jq -r '.data[].id'

Options

Name	Description
--base-url	API base URL (or set BIRD_API_URL)
--format, -f	Output format: json, text (default json)