Consumer Authentication

/

API reference

/

Errors

/

404

404 errors

billing_info_not_found

404Not found

Billing info could not be 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

biometric_registration_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

captcha_provider_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cname_record_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

crypto_wallet_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

default_provider_not_allowed

404Not found

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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

email_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

email_settings_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

email_template_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack


no_captcha_provider_configured

404Not found

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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

oauth_config_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

oauth_token_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

oauth_user_registration_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

organization_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

organization_user_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

otp_code_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

password_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

phone_number_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

project_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

project_user_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

public_token_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

recovery_codes_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

redirect_url_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

route_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

route_not_supported_in_test

404Not found

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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

secret_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

session_not_found

404Not 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

  • 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

sms_template_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

totp_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

totps_not_found_for_user

404Not found

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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

user_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

webauthn_registration_not_found

404Not 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"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack