●Change8

Migrating to Auth0 5.7.0

Version 5.7.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 6/10/2026

2
Breaking Changes
2
Migration Steps
25
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

branding.updateGetBrandingResponseContentUpdateBrandingResponseContentauth0.management.types.BrandingIdentifiersauth0.management.types.UpdateBrandingIdentifiersauth0.management.types.BrandingPhoneDisplayauth0.management.types.UpdateBrandingPhoneDisplayauth0.management.types.BrandingLoginDisplayEnumauth0.management.types.BrandingPhoneFormattingEnumauth0.management.types.BrandingPhoneMaskingEnumauth0.management.types.UpdateBrandingLoginDisplayEnumauth0.management.types.UpdateBrandingPhoneFormattingEnumauth0.management.types.UpdateBrandingPhoneMaskingEnumPhoneTemplateGetPhoneTemplateResponseContentCreatePhoneTemplateResponseContentUpdatePhoneTemplateResponseContentResetPhoneTemplateResponseContentGetTenantSettingsResponseContentUpdateTenantSettingsResponseContentConnectionOptionsCommonOidcUpdateConnectionOptionsClientMyOrganizationPostConfigurationClientMyOrganizationPatchConfigurationClientMyOrganizationResponseConfiguration

Breaking Changes

●Issue #1

The `identifiers` parameter has been removed from `branding.update()`. The corresponding `identifiers` field has been removed from `GetBrandingResponseContent` and `UpdateBrandingResponseContent`. Branding identifier types are no longer exported from `auth0.management.types`. These settings now reside exclusively on the theme resource (`PATCH /api/v2/branding/themes/{id}`).

●Issue #2

The `id` field on `PhoneTemplate`, `GetPhoneTemplateResponseContent`, `CreatePhoneTemplateResponseContent`, `UpdatePhoneTemplateResponseContent`, and `ResetPhoneTemplateResponseContent` is now `Optional[str]` instead of a required `str`. Code accessing `.id` without a `None` check must be updated.

Migration Steps

  1. 1
    If you were using the `identifiers` parameter in `branding.update()`, migrate those settings to the theme resource.
  2. 2
    Update code accessing the `.id` field on `PhoneTemplate` related types to handle potential `None` values.

Release Summary

This release refactors branding identifiers to the theme resource, makes the `id` field optional on phone template types, and adds several new fields related to tenant settings, connection options, and client configurations. Bug fixes address missing error handling for 404 and 409 responses in specific API calls.

Need More Details?

View the full release notes and all changes for Auth0 5.7.0.

View Full Changelog