Administrators may need to remove a custom email domain from a specific brand within an Okta environment. Remove the custom email domain by using the Brands API to retrieve the brand details, then update the configuration to clear the email domain values.

• Okta Identity Engine (OIE)
• Okta Classic Engine
• Branding
• Custom Email Domain
• Application Programming Interface (API)

How is a custom email domain removed from a brand using the API?

Download the Brands API collection, retrieve the specific brand identifier, and execute an update request with the email domain values removed to complete this process.

1. Download the Brands API Collection for Postman.
2. Retrieve the Brand ID from the Admin Console by navigating to the specific brand and copying the value from the URL. Alternatively, use the Get Brands GET {{url}}/api/v1/brands API call.
3. Execute the Get Brand GET {{url}}/api/v1/brands/{{brandId}} call and copy the API response as shown in the following example.
   
4. Execute the Update Brand PUT {{url}}/api/v1/brands/{{brandId}} call and paste the copied API response into the body.
5. Remove the values from the emailDomainId and emailDomain sections to update the brand and successfully remove the email domain as demonstrated in the following example.
   

Related References

• Brands