Documentation
Sign inGet started

bird email

Usage

Exemple de code
bird email

Description

A send names a from address on a verified sending domain and is accepted for delivery rather than delivered on the call, so a message's outcome is read back afterwards.
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

Templates

NameDescription
templatesAuthor and manage reusable email templates

Deliverability

NameDescription
domainsManage email sending domains
dedicated-ipsBuy, warm, and pool dedicated sending IPs
ip-poolsGroup dedicated IPs into pools a send can target
suppressionsManage the email suppression list
toolsEmail deliverability tools

Inbound

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

Agent Mailboxes

NameDescription
mailboxesManage agent email mailboxes
threadsRead and reply to mailbox conversation threads

Broadcasts

NameDescription
broadcastsSend one piece of content to a stored audience

Analytics

NameDescription
statsRead aggregate email statistics