Skip to main content
Before your AI can send email, you need to verify ownership of your domain. ActionLayer creates four DNS records — DKIM, SPF, MX, and an ownership TXT — that must all pass verification before any identity on that domain can send.

​
Adding a Domain

curl -X POST https://api.actionlayer.dev/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourcompany.com"}'
The response includes the four DNS records to add at your registrar.

​
DNS Records

RecordPurpose
DKIMCryptographic signing — proves email came from your domain
SPFLists ActionLayer as an authorized sender
MXRoutes inbound email to ActionLayer for parsing
Ownership TXTProves you control the domain
All four must be verified: true before you can send.

​
Verifying DNS

Once you’ve added all records, trigger verification: 
curl -X POST https://api.actionlayer.dev/v1/domains/{domain_id}/verify \
  -H "Authorization: Bearer YOUR_API_KEY"
DNS propagation typically takes a few minutes but can take up to 48 hours. The API returns the current status of each record individually.

​
Domain States

StatusMeaning
pendingNot yet verified
verifiedAll four records confirmed
failedOne or more records failed — check your DNS config

​
Notes

  • One domain can host multiple sender identities (e.g. support@, billing@, alex@)
  • You own the domain — ActionLayer never registers domains on your behalf
  • Inbound routing only works after the MX record is verified