Admin Authentication API Errors

Here is a full list of the error codes and descriptions, including recommended resolution steps, that are thrown by the Firebase Admin Node.js Authentication API:

Error Code Description and Resolution Steps
auth/claims-too-large The claims payload provided to setCustomUserClaims() exceeds the maximum allowed size of 1000 bytes.
auth/invalid-argument An invalid argument was provided to an Authentication method. The error message should contain additional information.
auth/invalid-claims The custom claim attributes provided to setCustomUserClaims() are invalid.
auth/invalid-disabled-field The provided value for the disabled user property is invalid. It must be a boolean.
auth/invalid-display-name The provided value for the displayName user property is invalid. It must be a non-empty string.
auth/invalid-email-verified The provided value for the emailVerified user property is invalid. It must be a boolean.
auth/invalid-email The provided value for the email user property is invalid. It must be a string email address.
auth/invalid-page-token The provided next page token in listUsers() is invalid. It must be a valid non-empty string.
auth/invalid-password The provided value for the password user property is invalid. It must be a string with at least six characters.
auth/invalid-phone-number The provided value for the phoneNumber is invalid. It must be a non-empty E.164 standard compliant identifier string.
auth/invalid-photo-url The provided value for the photoURL user property is invalid. It must be a string URL.
auth/invalid-uid The provided uid must be a non-empty string with at most 128 characters.
auth/missing-uid A uid identifier is required for the current operation.
auth/reserved-claims One or more custom user claims provided to setCustomUserClaims() are reserved. For example, OIDC specific claims such as (sub, iat, iss, exp, aud, auth_time, etc) should not be used as keys for custom claims.
auth/uid-alread-exists The provided uid is already in use by an existing user. Each user must have a unique uid.
auth/email-already-exists The provided email is already in use by an existing user. Each user must have a unique email.
auth/user-not-found There is no existing user record corresponding to the provided identifier.
auth/operation-not-allowed The provided sign-in provider is disabled for your Firebase project. Enable it from the Sign-in Method section of the Firebase console.
auth/invalid-credential The credential used to authenticate the Admin SDKs cannot be used to perform the desired action. Certain Authentication methods such as createCustomToken() and verifyIdToken() require the SDK to be initialized with a certificate credential as opposed to a refresh token or Application Default credential. See Initialize the SDK for documentation on how to authenticate the Admin SDKs with a certificate credential.
auth/phone-number-already-exists The provided phoneNumber is already in use by an existing user. Each user must have a unique phoneNumber.
auth/project-not-found No Firebase project was found for the credential used to initialize the Admin SDKs. See Add Firebase to your app for documentation on how to generate a credential for your project and use it to authenticate the Admin SDKs.
auth/insufficient-permission The credential used to initialize the Admin SDK has insufficient permission to access the requested Authentication resource. See Add Firebase to your app for documentation on how to generate a credential with appropriate permissions and use it to authenticate the Admin SDKs.
auth/internal-error The Authentication server encountered an unexpected error while trying to process the request. The error message should contain the response from the Authentication server containing additional information. If the error persists, please report the problem to our Bug Report support channel.

Send feedback about...

Need help? Visit our support page.