Skip to main content
POST
/
v1
/
domains
/
{id}
/
verify
Verify Domain
curl --request POST \
  --url https://api.example.com/v1/domains/{id}/verify

​
Verify Domain

Trigger verification of a domain’s DNS records.
​
id
string
required
The ID of the domain to verify.

​
Request

curl -X POST https://api.lettr.dev/v1/domains/dom_123abc/verify \
  -H "Authorization: Bearer le_xxxxxxxxxxxx"

​
Response (Success)

{
  "id": "dom_123abc",
  "object": "domain",
  "name": "example.com",
  "status": "verified",
  "spfStatus": "verified",
  "dkimStatus": "verified",
  "dmarcStatus": "verified",
  "verifiedAt": "2024-01-15T12:00:00Z"
}

​
Response (Partial Verification)

{
  "id": "dom_123abc",
  "object": "domain",
  "name": "example.com",
  "status": "pending",
  "spfStatus": "verified",
  "dkimStatus": "pending",
  "dmarcStatus": "verified",
  "missingRecords": [
    {
      "type": "CNAME",
      "host": "lettr._domainkey",
      "value": "dkim.lettr.dev",
      "purpose": "dkim"
    }
  ]
}

​
Verification Tips

DNS changes can take 15 minutes to 48 hours to propagate. Wait and retry.
Ensure DNS records match exactly, including trailing dots if required by your DNS provider.
If you have existing SPF records, merge them instead of creating duplicates.