In an environment where a custom email sender is configured for a custom brand, it is possible to copy the email sender domain to other custom brands.
The option to copy the sender to the Okta subdomain, however, is not possible through the user interface (UI).
This article provides steps for using the API to copy the sender email.
- Custom email
- Navigate to Okta Public API Collections.
- Sign in to Postman.
- The API calls can be run through the Postman web or desktop applications.
- Add the collection to the desired workspace.
- If assistance is required, please see Postman Integration or refer to the article in the Related References section below.
- Once the correct parameters for the URL and authorization token are set, the process of collecting the IDs of the properties involved can begin.
- Navigate to Email Domains > List all Email Domains. This will provide a full list of the custom email sender domains configured on this tenant.
- Search for the domain that has the following property set to Verified and copy the ID of the verified email domain, which is the custom email sender address in question:
"validationStatus": "VERIFIED"
- Next, we will find the ID of the Default Okta brand on the tenant.
- Within the API collection, navigate to Brands > Brand Operations > Get Brands.
- Search for the brand that has the following property set to True and copy the ID of the associated brand:
"isDefault": true
- Within the API collection, navigate to Brands > Brand Operations > Update/Replace Brand.
- Within the URL, update the brand ID with the ID of the default brand within the tenant.
- Within the payload of the API call, update the custom email domain ID with the verified email ID from the first API call made.
"name": "Brand Name","emailDomainId": "Custom email domain ID"
- Run the API call.
- Navigate to the Admin console to verify the change.
- Navigate to Customizations > Brands.
- The email Address field should now show the custom email sender applied to both the custom domain and the Default Okta domain.
- Customized emails can now be sent.
Related References
