Verify Domain

Refresh DNS verification for a sending domain. Use this endpoint after adding or changing DNS records so the returned dns array shows which records are valid and which records still need to be fixed.

Verification Behavior

How DNS verification refreshes work

  • The request body is empty.
  • Leadpush checks the domain with the mail provider and stores the latest DNS validity values.
  • The response includes dns[*].is_valid for every returned DNS record.
  • The domain must belong to the API key's workspace.
POST
/v1/domains/:domain/verification

Refresh DNS verification for a sending domain

Path parameters

domainstring Required

Domain UUID

Verify Domain
curl -X POST https://api.leadpush.io/v1/domains/:domain/verification \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"
Response Example
{
  "data": {
    "uuid": "<domain_uuid>",
    "name": "example.test",
    "domain": "example.test",
    "verified": true,
    "provider": "leadpush",
    "status": "pending",
    "verification": "completed",
    "mail_from_domain": "bounces.example.test",
    "mail_from_verified": true,
    "dns": [
      {
        "type": "CNAME",
        "name": "default._domainkey.example.test",
        "value": "default._domainkey.smtp-domain-1.leadpush.net.",
        "is_valid": true
      },
      {
        "type": "MX",
        "name": "bounces.example.test",
        "value": "10 bounces.leadpush.net",
        "is_valid": true
      }
    ],
    "updated_at": "2021-01-01T00:00:00.000Z",
    "created_at": "2021-01-01T00:00:00.000Z"
  }
}