Verify a domain
Pigeon accepts mail only from a domain you added and verified. The table on the domain card is the list to publish.
1. Add the domain
Open Domains and add the hostname you will put in the From address. That can be the apex, example.com, or a subdomain such as mail.example.com. Pigeon then shows one row per DNS record. Copy those rows. The samples in this guide use example.com. The ownership token and the three DKIM tokens are different for every domain.
2. Publish the records
Create the records at the company that hosts DNS for that domain. That is whoever answers the domain's nameservers. If the panel adds the zone for you, enter the host relative to the zone: _pigeon.example.com becomes _pigeon.
- Add a TXT record on _pigeon.yourdomain. The value is pigeon-verify= plus the token on the domain card. The token starts with pgv_.
- Add a TXT record on the domain itself: v=spf1 include:amazonses.com ~all. If an SPF record already exists, add include:amazonses.com inside it. A domain can have only one SPF TXT.
- Add a TXT record on _dmarc.yourdomain: v=DMARC1; p=none;
- Add each DKIM CNAME from the domain card. The host is token._domainkey.yourdomain and the target is token.dkim.amazonses.com. Keep the trailing dot on that target. There are three. If the DNS host offers a proxy, leave it off.
Automatic setup
On Domains, open DNS providers. Choose the company that hosts the zone, paste the credential, choose the domain, and save. On the domain card, check the rows to add and press Add selected. Pigeon writes those rows and leaves every other record in the zone alone. Verify then reads the same zone. The credential is stored encrypted, and the page shows its last four characters.
- Hetzner: an API token that can read and edit the DNS zone.
- DigitalOcean: an API token that can read and write domains.
- Amazon Route 53: an access key ID and a secret access key that can list hosted zones and change records.
- Cloudflare: an API token with the Edit zone DNS permission for that zone. Pigeon writes each DKIM CNAME with the proxy off, so the record stays DNS-only.
If you added a subdomain, Pigeon looks for a zone on that name and then on each parent, such as mail.example.com and then example.com. A token that cannot see a zone leaves the card for you to copy by hand.
3. Wait, then press Verify
New records are usually visible within a few minutes. A previous long TTL can make an update slower. 300 seconds is a good TTL for these records. Then press Verify on the domain card. Verify looks up every row and marks the ones that are still missing. The apex SPF row is optional.
4. Send
After the domain is verified, any From address on that hostname can send, for example Ada <ada@example.com>. You can also save a specific mailbox on the domain card and verify that address on its own. A different domain, or a subdomain you did not add, is rejected.
See each record with example hosts and values