Skip to content
DashboardGet API key

Verify an email domain

View .md
POST

Re-check the domain's published DNS records and refresh its status.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • domainIdstringrequired

Responses

200Verification re-checked.
  • domainobjectrequired
    5 properties
    • idstringrequired
    • domainstringrequired
    • statusstringrequired

      Overall verification status.

    • dkimStatusstringrequired
    • dnsRecordsobject[]

      DNS records to publish. Present when fetching a single domain or after adding one.

      6 properties
      • typestringrequired

        DNS record type.

      • namestringrequired

        Record host/name to create.

      • valuestringrequired

        Record value.

      • priorityinteger

        Priority (MX records only).

      • purposestringrequired

        What the record is for. ownership is a TXT at _zavu-verification.<domain>, returned only when another Zavu account also added this domain and neither has verified it: DKIM records are the same for everyone, so the domain verifies only once this account's own token is published.

        One ofdkimspfdmarcmail_fromownership
      • requiredbooleanrequired

        Whether the record is required to verify + send (DKIM) or recommended for deliverability.

401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Domain not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject
502The DNS check could not run right now. Nothing about the domain changed; retry shortly. Distinct from `404`, which means the domain is not in this project.
  • codestringrequired
  • messagestringrequired
  • detailsobject