Managing domains

For first-time setup, start with Verify a domain. This page covers the rest of the domain surface.

Lifecycle

• POST /domains: create (with optional region); SendSignal provisions DKIM with Amazon SES and returns the DNS record set to publish.
• POST /domains/{id}/verify: re-check DNS and SES status; run any time.
• GET /domains / GET /domains/{id}: list and inspect, including per-record status.
• PATCH /domains/{id}: update tracking settings.
• DELETE /domains/{id}: remove the domain.

Sending regions

Domains are provisioned in a sending region. GET /domains/regions lists the allowed regions; pass one as region on create. Verifying and sending happen in that region.

Ownership claiming

If you operate several teams (or migrate between them), DNS-based claiming proves ownership with a TXT challenge and makes the domain exclusive to your team:

1. POST /domains/{id}/claim: get the TXT challenge record.
2. Publish it, then POST /domains/{id}/claim/confirm.
3. POST /domains/{id}/claim/release: give the claim up later if needed.

A domain verified by another team can’t be sent from until you claim it: such sends fail with 403 domain_not_owned.