Verify DNS records for an email domain
Changed onChecks the published DNS records against the records required for the email domain and returns the latest verification results.
Request
- Base URL: https://api.telnyx.com/v2
- URL: https://api.telnyx.com/v2/email_domains/{domain_id}/verify
- Auth: HTTP bearer
Path parameters
Email domain UUID
Response
Updated email domain with latest DNS verification results
Example response
{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"record_type": "email_domain",
"domain": "example.com",
"type": "custom",
"status": "pending",
"usable_for_sending": false,
"usable_for_inbound": false,
"verification": {
"ownership": "pending",
"spf": "missing_optional",
"dkim": "pending",
"dmarc": "missing_optional",
"mx": "not_required"
},
"dns_records": [],
"dkim": {
"selector": null,
"algorithm": null,
"key_length": null,
"active": false,
"rotated_at": null
},
"inbound": {
"enabled": false,
"catch_all": false,
"mx_required": false
},
"dmarc_policy": {
"p": "none",
"pct": 100,
"rua": "mailto:dmarc@telnyx.com"
},
"tracking": {
"open_tracking": false,
"click_tracking": false,
"unsubscribe_tracking": false
},
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"verified_at": null
}
}Changes
- warning
added the new
40901enum value to the//response property for the response status - warning
added the new
40901enum value to the//response property for the response status - warning
added the new
40901enum value to the//response property for the response status - warning
added the new
40901enum value to the//response property for the response status
- warning
- warning
added the new
not_requiredenum value to the//response property for the response status - warning
added the new
not_requiredenum value to the//response property for the response status - warning
added the new
shared_inboundenum value to the/response property for the response status
- warning