Customization management

Learn about customization management tool scopes, features, and capabilities, with sample workflows and example prompts.

Early Access release

Tool name
okta_customization_management
Okta scopes
okta.brands.read, okta.brands.manage, okta.templates.read, okta.templates.manage, okta.domains.read, okta.domains.manage, okta.emailDomains.read, and okta.emailDomains.manage

What you can do

Brands

  • List, retrieve, create, replace, and delete brands
  • List custom domains that are associated with a brand

Themes

  • List and retrieve brand themes
  • Replace theme colors and touch-point variants
  • Upload and delete theme logo, favicon, and background image

Custom pages

  • Retrieve the default, customized, and preview versions of sign-in and error pages
  • Replace and delete the customized and preview versions of sign-in and error pages
  • Retrieve CDN asset URLs for sign-in and error pages
  • List available sign-in widget versions
  • Retrieve and replace sign-out page settings

Email templates

  • List and retrieve email templates and their customizations
  • Create, replace, and delete email customizations
  • Delete all customizations for an email template
  • Preview email customizations and default content
  • Retrieve and replace email template settings
  • Send a test email for a template

Custom domains

  • List, retrieve, create, replace, and delete custom domains
  • Upsert a TLS certificate for a custom domain
  • Trigger DNS verification for a custom domain

Email domains

  • List, retrieve, create, replace, and delete email domains
  • Trigger verification for an email domain

Key features

  • Support a preview (sandbox) copy of custom pages for testing, separate from the customized (live) copy applied to the org
  • Upload binary assets such as logo, favicon, and background image
  • Paginate through email template lists using a cursor
  • Reduce LLM token usage with token-optimized TSV responses
  • Restrict actions based on your granted OAuth scopes

Sample use cases

Use case Prompt Result
The admin is launching a new EU business unit and needs a dedicated brand for that audience, with the theme updated to the right visual identity and a custom domain ready so users get a fully branded sign-in experience. Create a custom brand called 'Acme EU', upload a logo to its theme, then create a custom domain for that brand and show me the updated brand and domain details. The 'Acme EU' brand is created, the theme logo is uploaded, the custom domain is created, and the updated brand and domain details are shown.
The admin is preparing for go-live and needs to make sure user-facing pages and emails are production-ready, with the customized sign-in page updated, a test email sent from the template, and email domain verification triggered so outbound mail trust is in progress. Replace the customized sign-in page for my brand, send a test email from the password reset template, then trigger verification for my email domain and show me the status. The customized sign-in page is replaced, a test email is sent from the selected template, email domain verification is triggered, and the current verification status is shown.