Documentation
Sign inGet started

bird email

Usage

Codebeispiel
bird email

Description

Send and inspect email messages, receive email at inbound addresses, and manage the email channel's deliverability resources — sending domains, dedicated IPs, and IP pools — under one group.
Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request.

Procedure

Send an email
Deliver email to explicit recipients. The sender must be a verified domain, or the shared onboarding domain on a new workspace; the result is accepted (queued, delivered asynchronously), not yet delivered.
Requires: The from must be a sender the workspace can use: a verified sending domain, or the shared onboarding domain on a new workspace.
  1. bird email send — Returns accepted (HTTP 202), delivered asynchronously; not confirmation of delivery. Next: bird email get

Messages

NameDescription
sendSend an email message.
send-batchSend a batch of email messages in one call.
getGet a message
listList messages
cancelCancel a scheduled message
contentGet stored message content
recipientsList recipients of a message

Deliverability

NameDescription
domainsManage email sending domains
dedicated-ipsManage dedicated IPs
ip-poolsManage IP pools
suppressionsManage the email suppression list
toolsEmail deliverability tools

Inbound

NameDescription
inbound-addressesManage inbound (forward) email addresses
inbound-messagesRead received (inbound) emails

Analytics

NameDescription
statsRead aggregate email statistics