The Sending Domains API allows you to authenticate custom domains for sending emails from a site. While it's possible to send emails without authenticating a domain, unauthenticated emails will either show the Wix domain to recipients or use the Wix domain as the From address with the Wix user's email as the Reply-To address. Authenticating a sending domain allows emails to use a custom domain in the From field, improving email deliverability, helping establish domain reputation, and helping email providers trust emails sent from a site.
With the Sending Domains API, you can:
The Sending Domains API is used to authenticate custom domains that have already been added to a site. Authentication requires adding DNS records to verify domain ownership. Once authenticated, the domain can be used in the From field for email campaigns and transactional emails sent from a site.
A sending domain progresses through these states during authentication:
INITIALIZING: The domain enters this state automatically when a Wix user verifies a sender email address and creates sender details. DNS records are being generated and are not yet available. This process typically takes a few minutes.
NOT_AUTHENTICATED. Call Get Sending Domain or Query Sending Domains to check the status.NOT_AUTHENTICATED: DNS records are available in the dnsRecords field and ready to be configured.
hostName and value from each record in the dnsRecords array.After adding records, DNS changes take time to propagate across the internet (typically a few hours, up to 48 hours). Then call Authenticate Sending Domain.
AUTHENTICATED: The domain is verified and ready for sending emails. Emails from addresses using this domain have improved deliverability.
It's important to note the following points before starting to code:
Authenticating a sending domain allows you to send emails from custom domain addresses. Without authentication, emails will either show the Wix domain to recipients or use the Wix domain as the From address with the Wix user's email as the Reply-To address. Only domains with AUTHENTICATED status can use custom domain addresses in the From field for email campaigns and transactional emails.
Before using the Sending Domains API, you must configure sender details for a site. Without completed sender details, all Sending Domains API methods return a SENDER_DETAILS_DO_NOT_EXIST error.
Configuring sender details requires creating and verifying a sender email, then creating sender details with that verified email. When you create sender details with a verified email address (for example, info@example.com), a sending domain for that email's domain (for example, example.com) becomes available for authentication. For a complete walkthrough of the setup process, see the Email Domain Setup Flow.
For domains purchased from Wix or connected via nameservers, DNS records are added automatically. For other domains, you need access to the domain's DNS configuration at the DNS provider (such as GoDaddy, Cloudflare, or Namecheap).
After adding DNS records at the DNS provider, it can take up to 48 hours for DNS changes to propagate globally. However, most changes typically propagate within a few hours.
example.com, you can authenticate it as a sending domain to send emails from addresses like info@example.com or support@example.com.INITIALIZING to NOT_AUTHENTICATED to AUTHENTICATED.