FirebaseUser

public @NonNullTask<Void> delete()

Deletes the user record from your Firebase project's database. If the operation is successful, the user will be signed out.

Important: this is a security sensitive operation that requires the user to have recently signed in. If this requirement isn't met, ask the user to authenticate again and later callreauthenticate.

• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid
• FirebaseAuthRecentLoginRequiredException thrown if the user's last sign-in time does not meet the security threshold. Usereauthenticate to resolve. This does not apply if the user is anonymous.

public abstract @NullableString getDisplayName()

Returns the main display name of this user from the Firebase project's user database. Unlike the display name property from instances ofUserInfo corresponding to authentication providers (like Google Sign-In), which is not modifiable, this name can be updated at any time by callingupdateProfile.

This field will be automatically populated on account creation if theAuthCredential used onsignInWithCredential contained such information.

public abstract @NullableString getEmail()

Returns the main email address of the user, as stored in the Firebase project's user database. Unlike the email property from instances ofUserInfo corresponding to authentication providers (like GitHub), which is not modifiable, this email address can be updated at any time by callingupdateEmail.

This field will be automatically populated on account creation if theAuthCredential used onsignInWithCredential contained such information, or if the account was created withcreateUserWithEmailAndPassword. However, this is not true if the setting "Multiple Accounts per Email" is enabled in the Firebase Console - in that case this will be null unless the account was created withcreateUserWithEmailAndPassword orupdateEmail has been called.

If the user also has a password, this email address can be used to sign in into the account usingsignInWithEmailAndPassword.

This email address is displayed in the Users section of the Firebase console.

public @NonNullTask<GetTokenResult> getIdToken(boolean forceRefresh)

Fetches a Firebase Auth ID Token for the user; useful when authenticating against your own backend. Use our server SDKs or follow the official documentation to securely verify the integrity and validity of this token.

• FirebaseAuthInvalidUserException ifforceRefresh == true, thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid

public abstract @NullableFirebaseUserMetadata getMetadata()

Returns theFirebaseUserMetadata associated with this user.

public abstract @NonNullMultiFactor getMultiFactor()

Returns aMultiFactor instance which is the main entry point for multi-factor related operations on this user.

public abstract @NullableString getPhoneNumber()

Returns the phone number of the user, as stored in the Firebase project's user database, ornull if none exists. This can be updated at any time by callingupdatePhoneNumber.

This field will be automatically populated on account creation if theAuthCredential used onsignInWithCredential contained such information. This phone number is displayed in the Users section of the Firebase console.

public abstract @NullableUri getPhotoUrl()

Returns the URL of this user's main profile picture, as stored in the Firebase project's user database. Unlike the profile URL property from instances ofUserInfo corresponding to authentication providers (like Facebook Login), which is not modifiable, this URL can be updated at any time by callingupdateProfile.

This field will be automatically populated on account creation if theAuthCredential used onsignInWithCredential contained such information.

public abstract @NonNullList<UserInfo> getProviderData()

Returns aList ofUserInfo objects that represents the linked identities of the user using different authentication providers that may be linked to their account. Use this to access, for example, your user's basic profile information retrieved from Facebook whether or not the user used Facebook Login to sign in to the current session.

public abstract @NonNullString getProviderId()

Always returnsPROVIDER_ID.

public abstract @NullableString getTenantId()

Returns the tenant ID of the current user ornull if this user isn't associated with a tenant project.

public abstract @NonNullString getUid()

Returns a string used to uniquely identify your user in your Firebase project's user database. Use it when storing information in Firebase Database or Storage, or even in your own backend.

This identifier is opaque and does not correspond necessarily to the user's email address or any other field.

public abstract boolean isAnonymous()

Returns true if the user is anonymous; that is, the user account was created withsignInAnonymously and has not been linked to another account withlinkWithCredential.

public @NonNullTask<AuthResult> linkWithCredential(@NonNullAuthCredential credential)

Attaches the givenAuthCredential to the user. This allows the user to sign in to this account in the future with credentials for such provider.

• FirebaseAuthWeakPasswordException thrown ifcredential instanceof EmailAuthCredential and the password is not strong enough
• FirebaseAuthInvalidCredentialsException thrown if thecredential is malformed or expired
• FirebaseAuthUserCollisionException thrown if there is another user account associated with the givencredential
• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid
• FirebaseAuthRecentLoginRequiredException thrown ifcredential instanceof EmailAuthCredential and if the user's last sign-in time does not meet the security threshold. Usereauthenticate to resolve. This does not apply if the user is anonymous.
• FirebaseAuthException thrown if there is an attempt to link a provider that is already linked to this account or if an internal error occurs

public @NonNullTask<Void> reauthenticate(@NonNullAuthCredential credential)

Reauthenticates the user with the given credential. This is useful for operations that require a recent sign-in, to prevent or resolve aFirebaseAuthRecentLoginRequiredException.

• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled or deleted
• FirebaseAuthInvalidCredentialsException thrown if thecredential is malformed or has expired, or if it corresponds to another existing user's account. Inspect the error code to desambiguate.

public @NonNullTask<AuthResult> reauthenticateAndRetrieveData(@NonNullAuthCredential credential)

Reauthenticates the user with the given credential, and returns the profile data for that account. This is useful for operations that require a recent sign-in, to prevent or resolve aFirebaseAuthRecentLoginRequiredException.

• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled or deleted
• FirebaseAuthInvalidCredentialsException thrown if thecredential is malformed or has expired, or if it corresponds to another existing user's account. Inspect the error code to desambiguate.

public @NonNullTask<Void> reload()

Manually refreshes the data of the current user (for example, attached providers, display name, and so on).

• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid

public @NonNullTask<Void> sendEmailVerification()

CallssendEmailVerification with nullactionCodeSettings.

public @NonNullTask<Void> sendEmailVerification(@NonNullActionCodeSettings actionCodeSettings)

Initiates email verification for the user. Takes in anActionCodeSettings to allow linking back to your app in the email.

public @NonNullTask<AuthResult> startActivityForLinkWithProvider(
    @NonNullActivity activity,
    @NonNullFederatedAuthProvider federatedAuthProvider
)

Links the user using the mobile browser (either a Custom Chrome Tab or the device's default browser) to the givenprovider. If the calling activity dies during this operation, usegetPendingAuthResult to get the outcome of this operation.

Note: this call has a UI associated with it, unlike the majority of calls in FirebaseAuth.

• FirebaseAuthInvalidCredentialsException thrown if the credential generated from the flow is malformed or expired.
• FirebaseAuthInvalidUserException thrown if the user has been disabled by an administrator.
• FirebaseAuthUserCollisionException thrown if the email that keys the user that is signing in is already in use.
• FirebaseAuthWebException thrown if there is an operation already in progress, the pending operation was canceled, there is a problem with 3rd party cookies in the browser, or some other error in the web context has occurred.
• FirebaseAuthException thrown if signing in via this method has been disabled in the Firebase Console, or if theprovider passed is configured improperly.

public @NonNullTask<AuthResult> startActivityForReauthenticateWithProvider(
    @NonNullActivity activity,
    @NonNullFederatedAuthProvider federatedAuthProvider
)

Reauthenticates the user using the mobile browser (either a Custom Chrome Tab or the device's default browser) using the givenprovider. If the calling activity dies during this operation, usegetPendingAuthResult to get the outcome of this operation.

Note: this call has a UI associated with it, unlike the majority of calls in FirebaseAuth.

• FirebaseAuthInvalidCredentialsException thrown if the credential generated from the flow is malformed or expired.
• FirebaseAuthInvalidUserException thrown if the user has been disabled by an administrator.
• FirebaseAuthUserCollisionException thrown if the email that keys the user that is signing in is already in use.
• FirebaseAuthWebException thrown if there is an operation already in progress, the pending operation was canceled, there is a problem with 3rd party cookies in the browser, or some other error in the web context has occurred.
• FirebaseAuthException thrown if signing in via this method has been disabled in the Firebase Console, or if theprovider passed is configured improperly.

public @NonNullTask<AuthResult> unlink(@NonNullString provider)

Detaches credentials from a given provider type from this user. This prevents the user from signing in to this account in the future with credentials from such provider.

• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid

public @NonNullTask<Void> updateEmail(@NonNullString email)

UseverifyBeforeUpdateEmail instead.

Updates the email address of the user.

Important: this is a security sensitive operation that requires the user to have recently signed in. If this requirement isn't met, ask the user to authenticate again and later callreauthenticate.

In addition, note that the original email address recipient will receive an email that allows them to revoke the email address change, in order to protect them from account hijacking.

• FirebaseAuthInvalidCredentialsException thrown if theemail address is malformed
• FirebaseAuthUserCollisionException thrown if there already exists an account with the givenemail address
• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid
• FirebaseAuthRecentLoginRequiredException thrown if the user's last sign-in time does not meet the security threshold. Usereauthenticate to resolve. This does not apply if the user is anonymous.
• FirebaseAuthException thrown with code OPERATION_NOT_ALLOWED ifEmail Enumeration Protection is enabled.

public @NonNullTask<Void> updatePassword(@NonNullString password)

Updates the password of the user.

Important: this is a security sensitive operation that requires the user to have recently signed in. If this requirement isn't met, ask the user to authenticate again and later callreauthenticate.

Anonymous users who update both their email and password will no longer be anonymous. They will be able to log in with these credentials.

• FirebaseAuthWeakPasswordException thrown if the password is not strong enough
• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid
• FirebaseAuthRecentLoginRequiredException thrown if the user's last sign-in time does not meet the security threshold. Usereauthenticate to resolve. This does not apply if the user is anonymous.

public @NonNullTask<Void> updatePhoneNumber(@NonNullPhoneAuthCredential credential)

Updates the phone number of the user.

Important: this is a security sensitive operation that requires the user to have recently signed in. If this requirement isn't met, ask the user to authenticate again and later callreauthenticate.

• FirebaseAuthUserCollisionException thrown if there already exists an account with the given phone number
• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid
• FirebaseAuthRecentLoginRequiredException thrown if the user's last sign-in time does not meet the security threshold. Usereauthenticate to resolve. This does not apply if the user is anonymous.

public @NonNullTask<Void> updateProfile(@NonNullUserProfileChangeRequest request)

Updates the user profile information. UseUserProfileChangeRequest.Builder to construct the request.

• FirebaseAuthInvalidUserException thrown if the current user's account has been disabled, deleted, or its credentials are no longer valid

public @NonNullTask<Void> verifyBeforeUpdateEmail(@NonNullString newEmail)

CallsverifyBeforeUpdateEmail without anyactionCodeSettings.

public @NonNullTask<Void> verifyBeforeUpdateEmail(
    @NonNullString newEmail,
    @NullableActionCodeSettings actionCodeSettings
)

Sends a verification email tonewEmail. Upon redemption of the link in the email, this user's email will be changed tonewEmail and that email will be marked verified.