Documentation
Sign inGet started
Get started
Guides
API Reference
SDKs
CLI
Knowledge Base
Changelog

bird email domains

Usage

Code example
bird email domains

Description

A from address must sit on a domain verified here. Verification is a DNS check you trigger and can repeat while records propagate, reported per record. Deleting a domain revokes sending from it; statistics and events for past sends survive.
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. Destructive commands require --yes.

Procedure

Register and verify a sending domain
Create a sending domain, add the returned DNS records at your DNS provider, then verify until it is green. DNS propagation is asynchronous.
  1. bird email domains create — Returns the domain in pending with the dns_records to configure. Add the returned DNS records at your DNS provider. Next: bird email domains get or bird email domains verify
  2. bird email domains verify — Triggers a fresh DNS check and returns the updated domain.

Commands

NameDescription
createAdd a sending domain and return the DNS records to configure
deleteDelete a sending domain
getGet a sending domain
listList sending domains
updateUpdate a sending domain's tracking settings and tracking domain
verifyVerify a domain

Related resources

Continue with the documentation, guides and examples for this topic. Resources are in English.

Understand the conceptSPF vs DKIM vs DMARC: what's the difference?Use the toolDMARC policy builderExplore the capabilitySending domainsImplementation guideDKIM, SPF & DMARC
Get an implementation brief