Skip to content
authreads Docs

Authentication sending domains

You can keep the Authreads sender permanently, or prove a dedicated subdomain and send your user-pool authentication messages from your own domain.

What changes — and what does not

If your company domain is example.com, Authreads uses the dedicated identity auth.example.com and sends from noreply@auth.example.com. Your root domain, website, employee mailboxes, and existing mail provider are not modified.

The sender name shown in an inbox is configured with the sending identity. It does not change when you turn optional email logo and colour presentation on or off.

Adoption is optional. A tenant that does nothing continues using the platform sender and is fully supported; it is not an incomplete or unhealthy configuration.

Setup workflow

  1. Add your company domain and the sender name recipients should recognise under Admin → Branding → Email → Sending identity.
  2. Publish the ownership TXT record shown there. No email-provider resource is created before this proof passes.
  3. After ownership is verified, create the sender records. Copy each name and value separately, copy all records, or download the BIND zone fragment; create the records without overwriting anything already at those names.
  4. Wait for DNS propagation, then run the checks. DNS can be correct while the sending provider is still verifying MAIL FROM; Admin reports that as “Waiting for provider.” Both checks must pass before activation is offered.
  5. Read the activation warning and activate the sender separately for each user pool.

DNS providers and caches control propagation. Small changes are often visible in minutes, but allow several hours before treating a pending result as a defect.

Deactivate and release

Returning a pool to the Authreads sender is reversible and leaves the verified sending resources in place. Releasing a domain is separate and permanent: every pool must first use the Authreads sender, then release removes only sending resources carrying Authreads' exact ownership tags. A partial provider failure stays visible and can be retried safely.

Authreads never removes your DNS records. After release completes, Admin identifies them as safe for you to remove. Registering the same domain again starts with a new ownership proof.

Failure and delivery health

Before activation, setup failures do not affect authentication mail. After activation, a required DNS, provider, event-routing, or reputation check that fails stops authentication email for that pool. Authreads does not silently substitute a different sender. An administrator can repair the records or deliberately return the pool to the platform sender.

Provider delivery events are best-effort. A recorded delivery, bounce, complaint, rejection, delay, or rendering failure is evidence that the provider reported it; a missing event is not proof of delivery. New domains also begin without established mailbox-provider reputation and may need a gradual warm-up period even when every DNS check is correct.

API record shapes

Sender-domain records expose a record purpose, whether it is required, its DNS type, exact name, and exact value. Pool settings expose the explicit platform or tenant_domain mode plus activation timestamps. Do not copy prose into an integration: the generated API reference is authoritative whenever an endpoint is part of the supported integration API.

  • Ownership: one required TXT record under the dedicated auth label.
  • DKIM: exactly three required CNAME records. Their selectors and targets are generated; never invent or derive them.
  • Custom MAIL FROM: one required MX record and one required SPF TXT record under bounce.auth.<your-domain>.
  • DMARC: an advisory TXT observation at the tenant domain. It is reported but is not an activation prerequisite.
These are shapes, not values. Copy the exact names and values generated in Admin for your registered domain; do not copy examples from documentation into DNS.