This article describes why emails may come from the default Okta subdomain rather than any configured custom domain and provides a method to ensure emails show the correct sending domain.
- Custom Email Domain
Emails sent from the Okta Admin Dashboard have the following expected behaviors:
- Orgs with no custom brands, domains, or email addresses
- Any emails sent from the Admin Dashboard will always come from the Okta subdomain and always appear with the Okta subdomain branding.
- Orgs with one custom brand, domain, and email address in addition to the default subdomain
- Emails triggered from the Admin Dashboard will always come from the Okta subdomain.
- These emails will not use the custom email address.
- Custom brand theming will appear in any email content.
- Emails triggered from the Admin Dashboard will always come from the Okta subdomain.
- Orgs with two or more custom brands, domains, and email addresses
- Emails triggered from the Admin Dashboard will always come from the Okta subdomain and use the Okta subdomain branding.
To send an email from a configured custom email address, use the Okta API to trigger the email. As part of the API call, change the domain of the request to the custom domain associated with that brand.
- For example, to send a User Activation email, send a request to the Activate a User endpoint using the appropriate custom domain in the request.
More information can be found in the Okta Developer documentation Multibrand and emails.
