> Documentation index: https://firebase.google.com/support/llms.txt

To review release notes for the Firebase console and for other Firebase
platforms and related SDKs, refer to the
[Firebase Release Notes](https://firebase.google.com/support/releases.md.txt).

## Version 3.7.1 - 11 November 2026

### Authentication

- Updated `HttpUtils.EncodeQueryParams()` to percent-encode query parameter keys and string values in outgoing HTTP requests.
- Validated `tenantId` and `providerId` identifiers before constructing Authentication REST API requests.

### Cloud Messaging

- Fixed an issue on .NET Framework and .NET Standard 2.0 where `SubscribeToTopicAsync()` and `UnsubscribeFromTopicAsync()` failed because outgoing requests hardcoded HTTP/2. Requests now use HTTP/1.1 on .NET Framework 4.6.2 and .NET Standard 2.0, and HTTP/2 with fallback to HTTP/1.1 on .NET 6.0 and later.

## Version 3.7.0 - 24 September 2026

### Cloud Messaging

- Migrated the `SubscribeToTopicAsync()` and `UnsubscribeFromTopicAsync()` methods in the `FirebaseMessaging` class from the legacy Instance ID API to the Cloud Messaging v1 topic subscription API.
- Added the `SubscribeToTopicLegacyAsync()` and `UnsubscribeFromTopicLegacyAsync()` methods, which continue to call the legacy Instance ID API. These methods are deprecated and will be removed in a future release.

## 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](https://github.com/kanclalg) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/454).

## 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](https://github.com/zSlicker) for the
  [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/452).

## 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](https://firebase.google.com/docs/cloud-messaging/android/receive#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](https://github.com/martinwiboe) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/329).

## 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](https://github.com/levimatheri) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/203).

## 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](https://github.com/floppydisken) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/289).

## 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](https://github.com/DenSmoke) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/251).
- Upgraded the dependency `Google.Api.Gax` to the latest major version. Refer to the [migration guide](https://firebase.google.com/docs/reference/admin/dotnet/migrate-dotnet-v2.md.txt) 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](https://github.com/kcieslinski) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/141).

## 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](https://github.com/NiCoTinEz) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/109).

### 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`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/firebase-messaging.md.txt) class for managing topic subscriptions. Thanks [Leo-Mepham](https://github.com/Leo-Mepham) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/94).
- Added support for specifying the analytics label for notifications via [`AndroidFcmOptions`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/android-fcm-options.md.txt), [`ApnsFcmOptions`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/apns-fcm-options.md.txt) and [`FcmOptions`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/fcm-options.md.txt) classes. Thanks [RannyRanny](https://github.com/RannyRanny) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/89).
- Introduced a new [`FirebaseMessagingException`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/firebase-messaging-exception.md.txt) class and a [`MessagingErrorCode`](https://firebase.google.com/docs/reference/admin/dotnet/namespace/firebase-admin/messaging.md.txt#namespace_firebase_admin_1_1_messaging_1ac3482b9d4581255dee08b81ac3f677c9) 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()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#createuserasync) method for creating new user accounts.
- Added the [`UpdateUserAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#updateuserasync) method for updating exiting user accounts.
- Added the [`ListUsersAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#listusersasync) method for listing or iterating over all users accounts in a Firebase project. Thanks [ChristopherLenz](https://github.com/ChristopherLenz) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/77).

## Version 1.6.0 - June 05, 2019

### Authentication

- Added [`GetUserByEmailAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#getuserasync) and [`GetUserByPhoneNumberAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#getuserasync) methods for retrieving user accounts.

### Cloud Messaging

- Added [`WebpushFcmOptions`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/webpush-fcm-options.md.txt) API for specifying Webpush-specific notification options. Thanks [Odonno](https://github.com/Odonno) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/64).

## Version 1.5.0 - May 30, 2019

### Authentication

- Added a new [`GetUserAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#getuserasync) method that allows retrieving user accounts.
- Added a new [`DeleteUserAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#deleteuserasync) method that allows deleting user accounts.

## Version 1.4.0 - April 18, 2019

- The [`AppOptions`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/app-options.md.txt) 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()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/firebase-messaging.md.txt#sendmulticastasync) API for sending a message to a list of device registration tokens. Thanks [kentcb](https://github.com/kentcb) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/36).
- Added a new [`SendAllAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/firebase-messaging.md.txt#sendallasync) API for sending a list of messages as a single batch. Thanks [kentcb](https://github.com/kentcb) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/36).

## 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`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/messaging/firebase-messaging.md.txt) class for sending FCM messages.

## Version 1.1.0 - January 24, 2019

### Authentication

- A new [`SetCustomUserClaimsAsync()`](https://firebase.google.com/docs/reference/admin/dotnet/class/firebase-admin/auth/firebase-auth.md.txt#setcustomuserclaimsasync) method has been added to the `FirebaseAuth` class for setting custom claims on Firebase user accounts. Thanks [dominikfoldi](https://github.com/dominikfoldi) for the [contribution](https://github.com/firebase/firebase-admin-dotnet/pull/17).

## Version 1.0.0 - August 16, 2018

- Initial release of the Admin .NET SDK. See [Add the Firebase Admin SDK to your Server](https://firebase.google.com/docs/admin/setup.md.txt) 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.