Themes

These endpoints allow you to customize the look and feel of pages and templates, including the following:

• The Okta-hosted sign-in page
• The sign-out page
• Error pages
• Email templates
• The Okta End-User Dashboard

Each new org contains Okta default branding. You can upload your own assets (colors, background image, logo, and favicon) to replace the default assets. Then you can publish these assets directly to your pages and templates.

Notes:

• Some of the curl code examples on this page include SSWS API token authentication. However, Okta recommends scoped OAuth 2.0 and OIDC access tokens to authenticate with Okta management APIs. OAuth 2.0 and OIDC access tokens provide fine-grain control over the bearer's actions on specific endpoints. See Okta API authentication methods.
• Okta optimizes the primaryColorContrastHex and secondaryColorContrastHex properties for the highest contrast between the font color and the background or button color. To disable or override the contrast auto-detection, update either contrast value with an accepted contrast hex code. Any update disables future automatic optimizations for the contrast hex.
• Contrast color is used by pages to optimize the opacity of text color when primary or secondary color is used as the background.