Firebase Admin .NET SDK Release Notes Stay organized with collections Save and categorize content based on your preferences.

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

Version 3.6.0 - 8 July 2026

Cloud Messaging

• Deprecated the Token property in Message class and the Tokens property in MulticastMessage class. Use the new Fid and Fids properties instead.
• Added support for sending messages to Firebase installation IDs (FIDs) using the new Fid property in Message class and Fids property in MulticastMessage class.
• Updated the SendEachForMulticastAsync() API to support both Tokens and Fids targets.

Version 3.5.0 - 19 March 2026

Cloud Messaging

• Added support for BandwidthConstrainedOk and RestrictedSatelliteOk fields in FCM AndroidConfig.

Version 3.4.0 - 08 September, 2025

• Deprecated support for .NET 6.0 and 7.0. Use .NET 8.0 or higher when deploying the Admin SDK.

Authentication

• Updated ActionCodeSettings to support LinkDomain, allowing you to customize the Firebase Hosting domain used in email action flows. As part of this change, DynamicLinkDomain has been deprecated.

• Fixed an issue where Auth error codes were not correctly mapped to their corresponding FirebaseAuthException.

Version 3.3.0 - 09 July, 2025

Cloud Messaging

• Added support for LiveActivityToken field in FCM ApnsConfig. Thanks kanclalg for the contribution.

Version 3.2.0 - 24 April, 2025

Cloud Messaging

• Added support for proxy field in FCM AndroidNotification.

• Fixed an issue that caused AndroidConfig.Priority to be mapped to the incorrect level when set to normal. Thanks zSlicker for the contribution.

Version 3.1.0 - 07 November, 2024

Cloud Messaging

• Added the DirectBootOk field to the AndroidConfig type. See Receive FCM messages in direct boot mode for more information.

Version 3.0.1 - 12 September, 2024

Cloud Messaging

• Fixed an issue that caused EventTimestamp in Android Notifications to generate an invalid value. Thanks martinwiboe for the contribution.

Version 3.0.0 - 08 May, 2024

• Dropped support for .NET Framework 4.6.1. You must now use .NET Framework 4.6.2+ or .NET 6.0+.

Version 2.4.1 - 04 April, 2024

• Marked deprecated FCM batch send APIs with Obsolete tags.

• Deprecated support for .NET Framework 4.6.1. The next major version of the Admin SDK will terminate support for this framework. You should upgrade your runtime frameworks accordingly.

Version 2.4.0 - 12 July, 2023

Cloud Messaging

• Added SendEachAsync() and SendEachForMulticastAsync() APIs.
• SendAllAsync() and SendMulticastAsync() APIs are now deprecated. Use SendEachAsync() and SendEachForMulticastAsync() APIs instead.

Version 2.3.0 - 24 March, 2022

Cloud Messaging

• Added a series of new parameters to the AndroidNotification class that allow further customization of notifications that target Android devices. Thanks levimatheri for the contribution.

Version 2.2.0 - 17 June, 2021

Authentication

• Added the missing EMAIL_NOT_FOUND error code.
• Added support for using the authorization code flow with OpenID Connect (OIDC) providers.

Version 2.1.0 - 14 April, 2021

Authentication

• FirebaseAuth and TenantManager APIs now support running against Firebase emulator suite. Enable the emulator mode by setting the FIREBASE_AUTH_EMULATOR_HOST environment variable to point to the emulator Auth endpoint. Thanks floppydisken for the contribution.

Version 2.0.0 - 04 November, 2020

• Dropped support for netstandard1.5 and net45 target frameworks. Developers are now required to use netstandard2.0 or net461. Thanks DenSmoke for the contribution.
• Upgraded the dependency Google.Api.Gax to the latest major version. Refer to the migration guide for more details on how this change might affect your code.

Cloud Messaging

• MulticastMessage and SendAllAsync() APIs now support sending up to 500 messages in a batch.

Version 1.17.1 - 14 October, 2020

Authentication

• Updated the createCustomToken() API to use the new IAM credentials API for remote token signing.

Version 1.17.0 - 30 September, 2020

• Support for net45 and netstandard1.5 frameworks has been deprecated. Developers are advised to use net461 or netstandard2.0.

Version 1.16.0 - 09 September, 2020

Authentication

• Added TenantManager class, which provides APIs for creating, updating, retrieving and deleting tenants in GCIP-enabled Firebase projects.
• Added TenantAwareFirebaseAuth class, which provides APIs for tenant-scoped user management, token verification and IdP configuration management.
• Added TenantNotFound and TenantIdMismatch error codes to the AuthErrorCode enum.
• Added the nullable property TenantId to UserRecord and FirebaseToken classes.
• Fixed a bug in the ImportUsersAsync() API that was preventing the correct handling of user import errors.

Version 1.15.0 - 29 July, 2020

Authentication

• Added OidcProviderConfig and SamlProviderConfig classes for representing OIDC and SAML identity provider configurations.
• Added new APIs to FirebaseAuth to facilitate creating, retrieving, updating and deleting identity provider configurations.

Version 1.14.0 - 17 June, 2020

Authentication

• Added a new ImportUsersAsync() API for importing users in bulk.

Version 1.13.0 - 29 May, 2020

Authentication

• Added GetUsersAsync() and DeleteUsersAsync() APIs for retrieving and deleting user accounts in bulk.

Version 1.12.0 - 06 May, 2020

Authentication

• Added CreateSessionCookieAsync() method for creating Firebase session cookies from valid ID tokens.
• Added VerifySessionCookieAsync() method for verifying Firebase session cookies in backend applications.

Version 1.11.0 - 23 April, 2020

Authentication

• Added RevokeRefreshTokensAsync() API for revoking any previously issued refresh tokens to a user.
• Added VerifyIdTokenAsync() API overload that checks if a given ID token has been revoked since it was issued.

Version 1.10.0 - 09 April, 2020

Authentication

• Added GeneratePasswordResetLinkAsync() method for generating links for password reset flows.
• Added GenerateEmailVerificationLinkAsync() method for generating links for email verification flows.
• Added GenerateSignInWithEmailLinkAsync() method for generating links for email link sign-in flows.

Version 1.9.2 - 11 February, 2020

Authentication

• User management APIs now correctly raise ErrorCode.AlreadyExists when an already in-use email address is specified for a user. Thanks kcieslinski for the contribution.

Version 1.9.1 - 16 October, 2019

• SDK automatically retries HTTP requests that are failing due to low-level I/O errors and HTTP 503 errors.

Authentication

• ExportedUserRecord does not expose password hashes that are redacted due to lack of permissions in the service account credentials.

• Fixed an issue with IAM-based custom token signing, that resulted in permission errors.

Version 1.9.0 - 18 September, 2019

• Fixed an issue that caused async API calls to deadlock in some environments. Thanks NiCoTinEz for the contribution.

Authentication

• Introduced a new FirebaseAuthException class and an AuthErrorCode enum type for improved error handling support. All user management APIs now throw instances of the FirebaseAuthException class. This is a subclass of the existing FirebaseException type.
• ID token verification APIs now throw instances of the FirebaseAuthException class.
• CreateCustomTokenAsync() APIs now throw FirebaseAuthException if an error occurs while signing custom tokens. If the service account is not correctly configured, this API throws an InvalidOperationException.

Version 1.8.0 - August 07, 2019

Cloud Messaging

• Added SubscribeToTopicAsync() and UnsubscribeFromTopicAsync() methods to the FirebaseMessaging class for managing topic subscriptions. Thanks Leo-Mepham for the contribution.
• Added support for specifying the analytics label for notifications via AndroidFcmOptions, ApnsFcmOptions and FcmOptions classes. Thanks RannyRanny for the contribution.
• Introduced a new FirebaseMessagingException class and a MessagingErrorCode enum type for improved error handling support. All FCM APIs now throw instances of the FirebaseMessagingException class. This is a subclass of the existing FirebaseException type.

Version 1.7.0 - June 27, 2019

• Added netstandard2.0 to the TargetFrameworks list of the package.
• Began compiling releases on the .NET Framework instead of Mono. This should resolve some of the library linkage issues reported by developers on previous versions of the SDK.

Authentication

• Added the CreateUserAsync() method for creating new user accounts.
• Added the UpdateUserAsync() method for updating exiting user accounts.
• Added the ListUsersAsync() method for listing or iterating over all users accounts in a Firebase project. Thanks ChristopherLenz for the contribution.

Version 1.6.0 - June 05, 2019

Authentication

• Added GetUserByEmailAsync() and GetUserByPhoneNumberAsync() methods for retrieving user accounts.

Cloud Messaging

• Added WebpushFcmOptions API for specifying Webpush-specific notification options. Thanks Odonno for the contribution.

Version 1.5.0 - May 30, 2019

Authentication

• Added a new GetUserAsync() method that allows retrieving user accounts.
• Added a new DeleteUserAsync() method that allows deleting user accounts.

Version 1.4.0 - April 18, 2019

• The AppOptions class now supports specifying an HttpClientFactory, which is useful when deploying the SDK behind a proxy server.

Version 1.3.0 - March 28, 2019

Cloud Messaging

• Added a new SendMulticastAsync() API for sending a message to a list of device registration tokens. Thanks kentcb for the contribution.
• Added a new SendAllAsync() API for sending a list of messages as a single batch. Thanks kentcb for the contribution.

Version 1.2.1 - March 20, 2019

Authentication

• The VerifyIdTokenAsync() method now tolerates a clock skew of up to 5 minutes when comparing JWT timestamps.

Version 1.2.0 - February 14, 2019

Cloud Messaging

• A new FirebaseMessaging class for sending FCM messages.

Version 1.1.0 - January 24, 2019

Authentication

• A new SetCustomUserClaimsAsync() method has been added to the FirebaseAuth class for setting custom claims on Firebase user accounts. Thanks dominikfoldi for the contribution.

Version 1.0.0 - August 16, 2018

• Initial release of the Admin .NET SDK. See Add the Firebase Admin SDK to your Server to get started.
• You can configure the SDK to use service account credentials, user credentials (refresh tokens), or Google Cloud application default credentials to access your Firebase project.

Authentication

• The initial release includes the CreateCustomTokenAsync(), VerifyIdTokenAsync() methods for minting custom authentication tokens and verifying Firebase ID tokens.