Skip to content

Documentation

403 domain_not_verified.

The from address is on a domain that has not finished verification, so nothing was sent.

What it means

You can only send from a domain whose DNS records have been published and checked. If the from address is on a domain that is not verified, the API answers 403 domain_not_verified, and an SMTP client gets a 550. The delivery network can also refuse a message later for the same reason, in which case the message shows a diagnosis of "Sending domain is not verified".

Typical codes and wording
403 domain_not_verified (API), 550 (SMTP)

Common causes

  • The records were never published, or only some of them were.
  • The records were published at the wrong name, or the value was shortened by the DNS provider's interface.
  • A proxied (orange cloud) DNS record where the record must be DNS only.
  • The domain was verified with another provider: that does not carry over, because the records are different.
  • DNS has not propagated yet, which can take from minutes to a few hours.

What to do

  1. Open Domains and the domain's page: it lists each record and whether it is verified.
  2. Fix the ones that are not, using the exact host and value shown. Many DNS providers add the domain name for you, so enter only the part before it.
  3. Re-check the domain. Verification also runs on its own every few minutes while a domain is waiting.
  4. Send from an address on the verified domain.
  5. To test your code before DNS is ready, send to delivered@mailtruss.test, which works without a verified domain.

What Mailtruss shows

The API returns 403 with the error name domain_not_verified and a message. A message that was refused later shows the diagnosis "Sending domain is not verified" with a link to the domain's DNS setup.

Is it safe to retry?

Yes, once the domain shows Verified.

Last updated

Something wrong or unclear on this page?

Report an issue