Billing info could not be found.
404 errors
billing_info_not_found
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "billing_info_not_found",
"error_message": "Billing info could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#billing_info_not_found"
}
biometric_registration_not_found
Biometric registration could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "biometric_registration_not_found",
"error_message": "Biometric registration could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#biometric_registration_not_found"
}
captcha_provider_not_found
Captcha Provider config could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "captcha_provider_not_found",
"error_message": "Captcha Provider config could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#captcha_provider_not_found"
}
cname_record_not_found
Could not find cname record using the values provided.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cname_record_not_found",
"error_message": "Could not find cname record using the values provided.",
"error_url": "https://stytch.com/docs/api/errors/404#cname_record_not_found"
}
crypto_wallet_not_found
Crypto wallet could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "crypto_wallet_not_found",
"error_message": "Crypto wallet could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#crypto_wallet_not_found"
}
default_provider_not_allowed
The Stytch Default OAuth Provider is not compatible with this feature, which requires additional configuration for your project. Please configure your own OAuth provider in the dashboard at https://stytch.com/dashboard/oauth.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "default_provider_not_allowed",
"error_message": "The Stytch Default OAuth Provider is not compatible with this feature, which requires additional configuration for your project. Please configure your own OAuth provider in the dashboard at https://stytch.com/dashboard/oauth.",
"error_url": "https://stytch.com/docs/api/errors/404#default_provider_not_allowed"
}
email_not_found
There is not a user in this project associated with the supplied email or email_id.
Common causes
The user mistypes their email when trying to authenticate via an email-based method which does not fall back to creating a new user. This includes password, magic link (via send), and OTP (via send) authentication.
Troubleshooting steps
Prompt the user to check their inputted email, and try again
Consider using a loginOrCreate method if you would like new users to be able to authenticate
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "email_not_found",
"error_message": "Email could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#email_not_found"
}
email_settings_not_found
Email Settings could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "email_settings_not_found",
"error_message": "Email Settings could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#email_settings_not_found"
}
email_template_not_found
Email Template could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "email_template_not_found",
"error_message": "Email Template could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#email_template_not_found"
}
magic_link_not_found
The magic link could not be authenticated, try sending another magic link to the user.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "magic_link_not_found",
"error_message": "The magic link could not be authenticated, try sending another magic link to the user.",
"error_url": "https://stytch.com/docs/api/errors/404#magic_link_not_found"
}
no_captcha_provider_configured
There's no Captcha Provider configured for this platform. Please configure the captcha config at https://stytch.com/dashboard/captcha/recaptcha.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_captcha_provider_configured",
"error_message": "There's no Captcha Provider configured for this platform. Please configure the captcha config at https://stytch.com/dashboard/captcha/recaptcha.",
"error_url": "https://stytch.com/docs/api/errors/404#no_captcha_provider_configured"
}
oauth_config_not_found
The OAuth config was not found. You can configure your OAuth providers in the dashboard at https://stytch.com/dashboard/oauth.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_config_not_found",
"error_message": "The OAuth config was not found. You can configure your OAuth providers in the dashboard at https://stytch.com/dashboard/oauth.",
"error_url": "https://stytch.com/docs/api/errors/404#oauth_config_not_found"
}
oauth_token_not_found
The OAuth token provided can not be found. This may be because the token never existed, or has already been used successfully.
Common causes
The web app is attempting to authenticate the token multiple times. In this case, the first attempt results in a successful response, but all following attempts result in this error.
Troubleshooting steps
Review your code which grabs the token from the redirect URL query params and authenticates the token. Each token can only be authenticated once.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_not_found",
"error_message": "OAuth Token could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#oauth_token_not_found"
}
oauth_user_registration_not_found
OAuth user registration could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_user_registration_not_found",
"error_message": "OAuth user registration could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#oauth_user_registration_not_found"
}
organization_not_found
Organization could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "organization_not_found",
"error_message": "Organization could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#organization_not_found"
}
organization_user_not_found
Organization User could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "organization_user_not_found",
"error_message": "Organization User could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#organization_user_not_found"
}
otp_code_not_found
The passcode provided was incorrect and could not be authenticated.
Common causes
The user is not providing the correct OTP code for their authentication attempt. They may have mistyped the value, or are referencing an old or unassociated OPT code.
Troubleshooting steps
Ask the user to try again. Additionally, provide an option for the user to send a new code if they are unable to authenticate.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "otp_code_not_found",
"error_message": "The passcode was incorrect and could not be authenticated, encourage the user to try inputting the passcode again or send another passcode.",
"error_url": "https://stytch.com/docs/api/errors/404#otp_code_not_found"
}
password_not_found
The password could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "password_not_found",
"error_message": "The password could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#password_not_found"
}
phone_number_not_found
The provided phone number is not attached to an existing User.
Common causes
Calling a /send instead of a login_or_create endpoint for a new user; /send will only succeed given a phone number which is already attached to an existing User.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "phone_number_not_found",
"error_message": "Phone Number could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#phone_number_not_found"
}
project_not_found
Project could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "project_not_found",
"error_message": "Project could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#project_not_found"
}
project_user_not_found
Project User could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "project_user_not_found",
"error_message": "Project User could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#project_user_not_found"
}
public_token_not_found
public_token could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "public_token_not_found",
"error_message": "public_token could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#public_token_not_found"
}
recovery_codes_not_found
Recovery codes could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "recovery_codes_not_found",
"error_message": "Recovery codes could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#recovery_codes_not_found"
}
redirect_url_not_found
Redirect URL could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "redirect_url_not_found",
"error_message": "Redirect URL could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#redirect_url_not_found"
}
route_not_found
The route provided is not supported.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "route_not_found",
"error_message": "The route provided is not supported.",
"error_url": "https://stytch.com/docs/api/errors/404#route_not_found"
}
route_not_supported_in_test
This route is not supported in the test environment. Please use api.stytch.com instead.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "route_not_supported_in_test",
"error_message": "This route is not supported in the test environment. Please use api.stytch.com instead.",
"error_url": "https://stytch.com/docs/api/errors/404#route_not_supported_in_test"
}
secret_not_found
Secret could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "secret_not_found",
"error_message": "Secret could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#secret_not_found"
}
session_not_found
The session could not be found. It could be revoked, expired, or nonexistent.
Common causes
When a session expires or is revoked, Stytch will return a session_not_found error for an attempt to authenticate it.
A user returns to a browser session after a long period of inactivity.
A user is deleted and their session is automatically revoked.
Troubleshooting steps
You can pull all of a user’s active sessions using the get sessions endpoint.
In most cases, a session_not_found error should prompt your app to re-authenticate the user; their session was either revoked, expired, or otherwise no longer exists. They’ll need to generate a new session.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "session_not_found",
"error_message": "Session could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#session_not_found"
}
sms_template_not_found
Unable to find the requested SMS template.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "sms_template_not_found",
"error_message": "Unable to find the requested SMS template.",
"error_url": "https://stytch.com/docs/api/errors/404#sms_template_not_found"
}
totp_not_found
The TOTP could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "totp_not_found",
"error_message": "The TOTP could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#totp_not_found"
}
totps_not_found_for_user
Unable to authenticate totp_code since no active or pending TOTPs could be found for the user.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "totps_not_found_for_user",
"error_message": "Unable to authenticate totp_code since no active or pending TOTPs could be found for the user.",
"error_url": "https://stytch.com/docs/api/errors/404#totps_not_found_for_user"
}
user_not_found
User could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_not_found",
"error_message": "User could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#user_not_found"
}
webauthn_registration_not_found
The WebAuthn registration could not be found.
Error
{
"status_code": 404,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "webauthn_registration_not_found",
"error_message": "The WebAuthn registration could not be found.",
"error_url": "https://stytch.com/docs/api/errors/404#webauthn_registration_not_found"
}