Firebase Admin Python SDK Release Notes

To review release notes for the Firebase console and for other Firebase platforms and related SDKs, refer to the Firebase Release Notes.

Version 7.6.0 - 17 September 2026

App Check

  • Added support for replay protection in the app_check.verify_token() API.

Firebase ML

  • Deprecated the Firebase ML module and its associated classes and functions ahead of the service turndown on June 15, 2027. If you host custom models, migrate to Cloud Storage for Firebase.

Version 7.5.0 - 02 July 2026

Cloud Messaging

  • Deprecated the token parameter in Message class and the tokens parameter in MulticastMessage class. Use the new fid and fids parameters instead.
  • Added support for sending messages to Firebase installation IDs (FIDs) using the new fid parameter in Message class and fids parameter in MulticastMessage class.
  • Updated the send_each_for_multicast() and send_each_for_multicast_async() functions to support both token and fid target types.

Version 7.4.0 - 09 April 2026

Firebase Phone Number Verification

  • Added a new phone_number_verification.verify_token() API to verify Firebase Phone Number Verification tokens.

Version 7.3.0 - 19 March 2026

Cloud Messaging

  • Added support for bandwidth_constrained_ok and restricted_satellite_ok fields in FCM AndroidConfig.

  • Fixed an issue where debug error logs were created when making calls to send_each_async and send_each_for_multicast_async. Thanks Plonq for the contribution.

Version 7.2.0 - 25 February, 2026

Cloud Functions

  • Added Cloud Task emulator support when using the CLOUD_TASKS_EMULATOR_HOST environment variable.

  • Fixed an issue during cold starts where credentials were not loaded before enqueuing the first task.

Authentication

  • Fixed an issue in the error code parsing logic where extra whitespace in error messages caused known error codes to be incorrectly mapped to unknown errors.

Version 7.1.0 - 31 July, 2025

Authentication

  • Updated ActionCodeSettings to support link_domain, allowing you to customize the Firebase Hosting domain used in email action flows. As part of this change, dynamic_link_domain has been deprecated. Thanks huwmartin for The contribution.

Version 7.0.0 - 17 July, 2025

  • Dropped support for Python 3.7 and 3.8.
  • Deprecated support for Python 3.9. Use Python 3.10 or higher when deploying the Admin SDK.

  • Removed the dependency on google-api-python-client greatly reducing the SDK's bundle size.

  • Upgraded google-cloud-firestore dependency version to to 2.21.0+.

  • Upgraded google-cloud-storage dependency version to 3.1.1+.

  • Upgraded google-api-core dependency version to 2.25.1+.

Cloud Messaging

  • Dropped support for send_all() and send_multicast() APIs. Use send_each() and send_each_for_multicast() APIs or their async counter parts send_each_async() and send_each_for_multicast_async() APIs instead.

Firebase ML

  • Dropped AutoML model support.

Cloud Functions

  • Replaced usage of deprecated datetime.utcnow() with datetime.now(timezone.utc).

Version 6.9.0 - 05 June, 2025

Cloud Messaging

  • Added support for live_activity_token field in FCM APNSConfig.
  • Added send_each_async() and send_each_for_multicast_async() APIs with async and HTTP/2 support.
  • Optimized success count calculation in BatchResponse. Thanks mingi3314 for the contribution.

Version 6.8.0 - 24 April, 2025

  • Deprecated support for Python 3.8. Use Python 3.9 or higher when deploying the Admin SDK.

Cloud Messaging

  • Added support for proxy field in FCM AndroidNotification.

Version 6.7.0 - 12 March, 2025

Remote Config

Realtime Database

  • Fixed a bug that caused reference listeners to ignore the database name set when connected to the Realtime Database emulator. Thanks aiueo-1234 for the contribution.

Version 6.6.0 - 07 November, 2024

  • Added support for passing google.auth typed credentials directly into initialize_app().

Cloud Firestore

  • Upgraded the google-cloud-firestore dependency to v2.19.0.
  • Added support for multiple Cloud Firestore named databases.

Version 6.5.0 - 11 March, 2024

  • Added new exceptions to handle rate limiting auth errors. Thanks skion for the contribution.
  • Exported rate limiting auth errors types TooManyAttemptsTryLaterError and ResetPasswordExceedLimitError.

Cloud Functions

  • Added an API to enqueue functions with Cloud Tasks.

Version 6.4.0 - 23 January, 2024

Cloud Messaging

  • Exported send_each and send_each_for_multicast APIs from the Cloud Messaging module. Thanks MarcoTomasRodriguez for the contribution.
  • Enabled the direct_boot_ok parameter for FCM Android config.

Version 6.3.0 - 05 December, 2023

  • Deprecated support for Python 3.7. Use Python 3.8 or higher when deploying the Admin SDK.

Authentication

  • Correctly catch DefaultCredentialsError when looking up project_id.

  • Added optional clock_skew_seconds parameter for token generation in the verify_id_token() and verify_session_cookie() APIs. Thanks stillmatic for the contribution.

App Check

  • Add PyJWKClientError to raised errors documentation and handle possible uncaught errors.

Version 6.2.0 - 22 June, 2023

Cloud Messaging

  • Added send_each() and send_each_for_multicast() APIs.

  • send_all() and send_multicast() APIs are now deprecated. Use send_each() and send_each_for_multicast() APIs instead.

Authentication

  • Update Auth APIs to use v2 service endpoints.

Version 6.1.0 - 02 February, 2023

Cloud Firestore

  • Upgraded the google-cloud-firestore dependency to v2.9.1 to support the COUNT queries API.

Firebase ML

  • Deprecated AutoML model support. AutoML model support will be removed in the next major version.

Version 6.0.1 - 17 October, 2022

App Check

  • Included PyJWT dependency in the distribution artifacts.

Version 6.0.0 - 06 October, 2022

  • Dropped support for Python 3.6. Developers should use Python 3.7 or higher with the Admin SDK.

App Check

  • Added a new app_check.verify_token() API to verify App Check tokens.

Version 5.4.0 - 22 September, 2022

  • Deprecated support for Python 3.6. Developers are advised to use Python 3.7 or higher when deploying the Admin SDK.

Authentication

  • Fixed an incorrect key used to set memory_cost config in the auth.UserImportHash.standard_scrypt() API.

Version 5.3.0 - 25 August, 2022

Cloud Firestore

  • Added asynchronous support for Cloud Firestore APIs.

Version 5.2.0 - 15 December, 2021

Authentication

  • Added support for configuring the authorization code flow for OIDC providers.

Version 5.1.0 - 04 November, 2021

Authentication

  • Added the ability to delete providers from a user record by passing a list of provider IDs to the update_user() API. Thanks hardikns for the contribution.

Version 5.0.3 - 23 September, 2021

Authentication

  • Improved the performance of the list_users() API by reducing the amount of repeated processing that happens during pagination.

Version 5.0.2 - 13 August, 2021

Authentication

  • When check_revoked is set to True, the verify_id_token() and verify_session_cookie() APIs now throw an error if the user record is disabled.

Cloud Messaging

  • Fixed a concurrency issue in the send_all() and send_multicast() APIs by instantiating a new googleapiclient transport instance for each invocation of those functions.

Version 5.0.1 - 17 June, 2021

Authentication

  • Added the missing EMAIL_NOT_FOUND error code.

Version 5.0.0 - 28 April, 2021

  • Dropped support for Python 3.5. Developers should use Python 3.6 or higher when deploying the Admin SDK.
  • Upgraded google-cloud-firestore dependency version to to 2.1.0.
  • Upgraded google-cloud-storage dependency version to 1.37.1.
  • Upgraded google-api-core dependency version to 1.22.1.
  • The SDK now accepts path-like objects in credential factory functions.

Authentication

  • Added Authentication emulator support via the FIREBASE_AUTH_EMULATOR_HOST environment variable. Thanks muru for the contribution.

Version 4.5.3 - 18 March, 2021

Authentication

Version 4.5.2 - 18 February, 2021

  • Fixed a bug that prevented the proper operation of the SDK when used with certain versions of the urllib3 package. Thanks xmo-odoo for the contribution.

Version 4.5.1 - 12 January, 2021

Realtime Database

  • Added support for handling RTDB URLs that point to instances hosted in non-US regions.

Version 4.5.0 - 09 December, 2020

  • Deprecated support for Python 3.5. Developers are advised to use Python 3.6 or higher when deploying the Admin SDK.

Cloud Messaging

  • The SDK now correctly handles low-level runtime errors raised by the googleapiclient package while sending batch requests.

Version 4.4.0 - 15 September, 2020

Firebase ML

  • Added support for creating, updating, getting, listing, publishing, unpublishing, and deleting Firebase-hosted custom ML models created with AutoML.

Version 4.3.0 - 14 May, 2020

Authentication

  • Added get_users() and delete_users() APIs for retrieving and deleting user accounts in bulk.

Version 4.2.0 - 30 April, 2020

Authentication

  • Added a new tenant_mgt module that provides APIs for creating, updating, retrieving, and deleting authentication tenants.
  • Added a new tenant_mgt.auth_for_tenant() function that returns a client object scoped to a specific tenant for performing tenant-aware user management operations.
  • Added the auth.OIDCProviderConfig type and related functions to create, retrieve, update and delete OIDC auth provider configurations.
  • Added the auth.SAMLProviderConfig type and related functions to create, retrieve, update and delete SAML auth provider configurations.

Version 4.1.0 - 21 April, 2020

Firebase ML

  • Added a new ml module for creating, updating, getting, listing, publishing, unpublishing, and deleting Firebase-hosted custom ML models. See the Firebase documentation to learn more about how to use the Admin SDK to manage ML models.

Version 4.0.1 - 26 March, 2020

Cloud Messaging

  • Returning more descriptive error messages from the topic management APIs.

Realtime Database

  • Fixed a regression in the listen() API that prevented its use in the v4.0.0 release.

Version 4.0.0 - 24 February, 2020

  • Python 2 and 3.4 are no longer supported. Developers must use Python 3.5 or higher when using the Python Admin SDK.
  • Upgraded the cachecontrol dependency to the latest available.
  • The Admin SDK now sets a default timeout of 120 seconds on all outgoing HTTP requests.

Cloud Messaging

  • The AndroidNotification class now correctly formats the event_time field sent to the Firebase Cloud Messaging service.
  • Fixed an incorrect error message logged by the messaging module when calling the batch send APIs.

Version 3.2.1 - 11 December, 2019

Cloud Messaging

  • Boolean parameters in AndroidNotification are now correctly encoded.

Version 3.2.0 - 13 November, 2019

Cloud Messaging

  • Added a series of new parameters to the AndroidNotification class that allow further customization of notifications that target Android devices.
  • Batch messaging APIs send_all() and send_multicast() now support sending up to 500 messages in a single call.

Version 3.1.0 - 23 October, 2019

Authentication

  • Added auth.InsufficientPermissionError type to represent operations that fail due to the credential lacking a required permission.
  • User management APIs now correctly raise auth.EmailAlreadyExistsError when an already in-use email address is specified for a user.

Cloud Messaging

  • Message class now implements the __str__() contract which can be used to obtain a string representation of a Message instance.

Version 3.0.0 - 11 September, 2019

  • Python 2.7 support is now deprecated. Developers are advised to use Python 3.4 or higher to run the Admin SDK.
  • Removed old module-level exception types auth.AuthError, db.ApiCallError, messaging.ApiCallError, instance_id.ApiCallError and project_management.ApiCallError.
  • Added a new exceptions module that defines base exception types for the entire SDK. Public APIs now raise exceptions defined in the new exceptions module (or subtypes of them). This facilitates implementing fine-grained error handling logic for a wide range of scenarios that was not supported before. See the migration guide for instructions on how to port your existing error handling code.
  • Upgraded google-cloud-firestore dependency version to to 1.14.0.
  • Upgraded google-cloud-storage dependency version to 1.18.0.

Project Management

  • IosApp, IosAppMetadata and ShaCertificate types in the project_management module have been renamed to IOSApp, IOSAppMetadata and SHACertificate respectively.

Authentication

  • It is no longer possible to delete user properties with the update_user() API by setting properties to None. Setting properties to None leaves those properties unchanged. They must be explicitly set to auth.DELETE_ATTRIBUTE to delete them.

Cloud Messaging

  • Added support for sending an image URL in notifications. Thanks cchamm for the contribution.

  • The deprecated WebpushFcmOptions type has been removed. Developers must use the PEP8 compliant type name WebpushFCMOptions instead.

Version 2.18.0 - 21 August, 2019

Cloud Messaging

  • The WebpushFcmOptions type is now deprecated. Developers should use the PEP8 compliant type name WebpushFCMOptions instead.

  • Added support for specifying the Analytics label for notifications. Thanks willawang8908 for the contribution.

  • Added support for arbitrary key-value pairs in messaging.ApsAlert. Thanks viktorasl for the contribution.

Realtime Database

  • Developers can now test Realtime Database API calls by directing the SDK traffic to the RTDB emulator. Set the FIREBASE_DATABASE_EMULATOR_HOST environment variable to specify the emulator endpoint in host:port format.

Version 2.17.0 - May 23, 2019

Firebase Cloud Messaging