Cannot create a new TOTP for the specified user since the user already has an active TOTP. Users may only have one active TOTP at a time.
400 errors
active_totp_exists
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "active_totp_exists",
"error_message": "Cannot create a new TOTP for the specified user since the user already has an active TOTP. Users may only have one active TOTP at a time.",
"error_url": "https://stytch.com/docs/api/errors/400#active_totp_exists"
}apple_oauth_config_not_found
400Bad request
The Apple OAuth config was not found.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "apple_oauth_config_not_found",
"error_message": "The Apple OAuth config was not found.",
"error_url": "https://stytch.com/docs/api/errors/400#apple_oauth_config_not_found"
}argon_2_key_length_mismatch
400Bad request
The key_length value doesn't match the length of the provided hash.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "argon_2_key_length_mismatch",
"error_message": "The key_length value doesn't match the length of the provided hash.",
"error_url": "https://stytch.com/docs/api/errors/400#argon_2_key_length_mismatch"
}bad_request
400Bad request
The submitted request is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "bad_request",
"error_message": "The submitted request is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#bad_request"
}billing_not_verified
400Bad request
You cannot use this endpoint in the live environment until credit card details are added to your account, but you can try the endpoint in the test environment. Once your billing information is verified, this endpoint can be used in live. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please go to billing settings to provide billing information.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "billing_not_verified",
"error_message": "You cannot use this endpoint in the Live environment until credit card details are added to your account, but you can try the endpoint in the Test environment. Once your billing information is verified, this endpoint can be used in Live. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please go to https://stytch.com/settings/billing to provide billing information.",
"error_url": "https://stytch.com/docs/api/errors/400#billing_not_verified"
}billing_not_verified_for_email
400Bad request
You can only send magic links to emails matching your project's domain until credit card details are added to your account. Once your billing information is verified, emails can be sent to anyone. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please go to billing settings to provide billing information.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "billing_not_verified_for_email",
"error_message": "You can only send magic links to emails matching your project's domain until credit card details are added to your account. Once your billing information is verified, emails can be sent to anyone. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please see https://stytch.com/settings/billing to provide billing information.",
"error_url": "https://stytch.com/docs/api/errors/400#billing_not_verified_for_email"
}breached_password
400Bad request
Password doesn't meet the API's strength requirements. A password's strength could be tested with the password strength check endpoint.
Common causes
The password was previously leaked, and the password now appears in the HaveIBeenPwned dataset.
Troubleshooting steps
Use the password strength check endpoint endpoint to get actionable feedback on improving the strength of the password string. This feedback can be passed on to the end user via your UI.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "breached_password",
"error_message": "password appears in a list of breached passwords.",
"error_url": "https://stytch.com/docs/api/errors/400#breached_password"
}bulk_migrate_invalid_user_count
400Bad request
The number of users passed to bulk migrate password was invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "bulk_migrate_invalid_user_count",
"error_message": "The number of users passed to bulk migrate password was invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#bulk_migrate_invalid_user_count"
}cannot_delete_email
400Bad request
Cannot delete the last email for a user with a password. This ensures they can complete a password reset.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cannot_delete_email",
"error_message": "Cannot delete the last email for a user with a password. This ensures they can complete a password reset.",
"error_url": "https://stytch.com/docs/api/errors/400#cannot_delete_email"
}cannot_delete_last_primary_factor
400Bad request
You cannot delete the last primary factor (email, phone number, crypto wallet) for a user because that would make their account difficult or impossible to recover. If you want to remove the user from your project, delete the user instead.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cannot_delete_last_primary_factor",
"error_message": "Cannot delete the last primary factor (email, phone number, crypto wallet) for a user. If you want to delete the user instead, use the DeleteUser endpoint: https://stytch.com/docs/api/delete-user",
"error_url": "https://stytch.com/docs/api/errors/400#cannot_delete_last_primary_factor"
}cannot_reset_password_with_existing_password
400Bad request
Cannot reset user's password using their existing password. This could be because their existing password was part of a data breach or to prevent password squatting. Please reset the password via a session or email reset.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cannot_reset_password_with_existing_password",
"error_message": "Cannot reset user's password using their existing password. This could be because their existing password was part of a data breach or to prevent password squatting. Please reset the password via a session or email reset.",
"error_url": "https://stytch.com/docs/api/errors/400#cannot_reset_password_with_existing_password"
}cannot_use_biometrics_with_pending_user
400Bad request
Mobile biometrics can only be used for active users.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cannot_use_biometrics_with_pending_user",
"error_message": "Mobile biometrics can only be used for active users.",
"error_url": "https://stytch.com/docs/api/errors/400#cannot_use_biometrics_with_pending_user"
}cannot_use_webauthn_with_pending_user
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cannot_use_webauthn_with_pending_user",
"error_message": "WebAuthn can only be used for active users. To learn more about WebAuthn and user states read more at https://stytch.com/docs/api/webauthn-overview and https://stytch.com/docs/api/user-states.",
"error_url": "https://stytch.com/docs/api/errors/400#cannot_use_webauthn_with_pending_user"
}client_secret_too_long
400Bad request
Client secret is too long. Please make sure you have the correct value.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "client_secret_too_long",
"error_message": "Client secret is too long. Please make sure you have the correct value.",
"error_url": "https://stytch.com/docs/api/errors/400#client_secret_too_long"
}could_not_parse_biometric_signature
400Bad request
Could not parse the biometric signature. The field should be base64 encoded.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "could_not_parse_biometric_signature",
"error_message": "Could not parse the biometric signature. The field should be base64 encoded.",
"error_url": "https://stytch.com/docs/api/errors/400#could_not_parse_biometric_signature"
}custom_claims_too_large
400Bad request
Custom claims are too large.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "custom_claims_too_large",
"error_message": "Custom claims are too large.",
"error_url": "https://stytch.com/docs/api/errors/400#custom_claims_too_large"
}deprecated_endpoint
400Bad request
This endpoint has been deprecated
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "deprecated_endpoint",
"error_message": "This endpoint has been deprecated",
"error_url": "https://stytch.com/docs/api/errors/400#deprecated_endpoint"
}duplicate_biometric_registration
400Bad request
This biometric public key has already been registered. Please register a different key.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_biometric_registration",
"error_message": "This biometric public key has already been registered. Please register a different key.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_biometric_registration"
}duplicate_email
400Bad request
A user with the specified email already exists for this project.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_email",
"error_message": "A user with the specified email already exists for this project.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_email"
}duplicate_email_for_user
400Bad request
The specified email is already tied to this user.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_email_for_user",
"error_message": "The specified email is already tied to this user.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_email_for_user"
}duplicate_m2m_client_id
400Bad request
The client ID submitted is already in use by another client.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_m2m_client_id",
"error_message": "The client ID submitted is already in use by another client.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_m2m_client_id"
}duplicate_organization
400Bad request
An organization with the specified name already exists.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_organization",
"error_message": "An organization with the specified name already exists.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_organization"
}duplicate_organization_user
400Bad request
A user with the specified email already exists for this organization.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_organization_user",
"error_message": "A user with the specified email already exists for this organization.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_organization_user"
}duplicate_phone_number
400Bad request
The phone number provided is already associated with an existing Stytch user.
Common causes
You’re attempting to create a new Stytch user with a phone number that already belongs to an existing user.
Troubleshooting steps
Instead of creating a new user, locate the existing user via our Search users endpoint. You can search by user phone number by adding a phone_number filter to your search request.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_phone_number",
"error_message": "A user with the specified phone number already exists for this project.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_phone_number"
}duplicate_phone_number_for_user
400Bad request
The specified phone number is already tied to this user.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_phone_number_for_user",
"error_message": "The specified phone number is already tied to this user.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_phone_number_for_user"
}duplicate_project_user
400Bad request
A project user for the specified organization user already exists for this project.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_project_user",
"error_message": "A project user for the specified organization user already exists for this project.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_project_user"
}duplicate_redirect_url
400Bad request
A redirect URL already exists for the provided URL.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_redirect_url",
"error_message": "A redirect URL already exists for the provided URL.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_redirect_url"
}duplicate_wallet_address
400Bad request
A user with the specified crypto wallet address already exists for this project.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_wallet_address",
"error_message": "A user with the specified crypto wallet address already exists for this project.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_wallet_address"
}duplicate_wallet_address_for_user
400Bad request
The specified crypto wallet address is already tied to this user.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_wallet_address_for_user",
"error_message": "The specified crypto wallet address is already tied to this user.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_wallet_address_for_user"
}duplicate_webauthn_registration
400Bad request
The supplied credential ID already exists for this project.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_webauthn_registration",
"error_message": "The supplied credential ID already exists for this project.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_webauthn_registration"
}empty_webauthn_registration_name
400Bad request
Invalid name. Valid webauthn registration names are non-empty.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "empty_webauthn_registration_name",
"error_message": "Invalid name. Valid webauthn registration names are non-empty.",
"error_url": "https://stytch.com/docs/api/errors/400#empty_webauthn_registration_name"
}expired_totp
400Bad request
The TOTP for this user has expired without being verified.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "expired_totp",
"error_message": "The TOTP for this user has expired without being verified.",
"error_url": "https://stytch.com/docs/api/errors/400#expired_totp"
}id_token_expired
400Bad request
ID token is expired.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "id_token_expired",
"error_message": "ID token is expired.",
"error_url": "https://stytch.com/docs/api/errors/400#id_token_expired"
}id_token_incorrect_audience
400Bad request
ID token's audience does not match the OAuth configuration's ID.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "id_token_incorrect_audience",
"error_message": "ID token's audience does not match the OAuth configuration's ID.",
"error_url": "https://stytch.com/docs/api/errors/400#id_token_incorrect_audience"
}id_token_invalid
400Bad request
ID token is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "id_token_invalid",
"error_message": "ID token is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#id_token_invalid"
}id_token_nonce_invalid
400Bad request
The provided nonce does not match the nonce in the ID token.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "id_token_nonce_invalid",
"error_message": "The provided nonce does not match the nonce in the ID token.",
"error_url": "https://stytch.com/docs/api/errors/400#id_token_nonce_invalid"
}inactive_email
400Bad request
The email provided has been marked as inactive by our email provider. This happens most often when the email is undeliverable due to a hard bounce.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "inactive_email",
"error_message": "The email provided has been marked as inactive by our email provider. This happens most often when the email is undeliverable due to a hard bounce.",
"error_url": "https://stytch.com/docs/api/errors/400#inactive_email"
}incompatible_session_type
400Bad request
Session token and session duration are arguments for Stytch sessions. Leave these arguments blank when using IDP sessions.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "incompatible_session_type",
"error_message": "Session token and session duration are arguments for Stytch sessions. Leave these arguments blank when using IDP sessions.",
"error_url": "https://stytch.com/docs/api/errors/400#incompatible_session_type"
}insecure_m2m_client_secret
400Bad request
The client secret submitted is not secure enough. Please generate a more secure secret.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "insecure_m2m_client_secret",
"error_message": "The client secret submitted is not secure enough. Please generate a more secure secret.",
"error_url": "https://stytch.com/docs/api/errors/400#insecure_m2m_client_secret"
}invalid_append_salt
400Bad request
The append_salt value is not supported because it's too long.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_append_salt",
"error_message": "The append_salt value is not supported because it's too long.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_append_salt"
}invalid_argon_2_iteration_amount
400Bad request
The iteration_amount value is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_argon_2_iteration_amount",
"error_message": "The iteration_amount value is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_argon_2_iteration_amount"
}invalid_argon_2_key_length
400Bad request
The key_length value is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_argon_2_key_length",
"error_message": "The key_length value is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_argon_2_key_length"
}invalid_argon_2_memory
400Bad request
The memory value is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_argon_2_memory",
"error_message": "The memory value is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_argon_2_memory"
}invalid_argon_2_salt
400Bad request
The salt value is an unsupported length.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_argon_2_salt",
"error_message": "The salt value is an unsupported length.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_argon_2_salt"
}invalid_argon_2_threads
400Bad request
The threads value is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_argon_2_threads",
"error_message": "The threads value is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_argon_2_threads"
}invalid_argument
400Bad request
Invalid argument.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_argument",
"error_message": "Invalid argument.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_argument"
}invalid_authentication_type
400Bad request
The authentication type provided in the header of the request is invalid. The Stytch API uses basic authentication. See more about authenticating Stytch API requests here.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_authentication_type",
"error_message": "The authentication type provided in the header of the request is invalid. The Stytch API uses basic authentication. See more about authenticating Stytch API requests here: https://stytch.com/docs/api/authentication",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_authentication_type"
}invalid_authenticator_type
400Bad request
Invalid authenticator type. The valid values are platform and cross-platform.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_authenticator_type",
"error_message": "Invalid authenticator type. The valid values are platform and cross-platform.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_authenticator_type"
}invalid_authorization_header
400Bad request
The authorization header provided with the request is invalid.
Common causes
HTTP request is missing an Authorization header
The Authorization header in the HTTP request is not formatted properly
The Authorization header in the HTTP request has the incorrect credentials
Troubleshooting steps
Check the Authorization header in the HTTP request for proper formatting.
Always use the Basic Auth type in the header.
Check the project credentials you entered match your API keys in the Dashboard.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_authorization_header",
"error_message": "The authorization header provided with the request is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_authorization_header"
}invalid_b2b_endpoint
400Bad request
The provided project_id is a Consumer project and this endpoint is only enabled for B2B projects. Please go to https://stytch.com/docs/home for the consumer version.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_b2b_endpoint",
"error_message": "The provided project_id is a Consumer project and this endpoint is only enabled for B2B projects. Please go to https://stytch.com/docs/home for the consumer version.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_b2b_endpoint"
}invalid_base64_scrypt_hash
400Bad request
The provided hash isn't a base64 encoded string. Please base64 encode the hash before passing it to this endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_base64_scrypt_hash",
"error_message": "The provided hash isn't a base64 encoded string. Please base64 encode the hash before passing it to this endpoint.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_base64_scrypt_hash"
}invalid_base64_scrypt_salt
400Bad request
The provided salt isn't a base64 encoded string. Please base64 encode the salt before passing it to this endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_base64_scrypt_salt",
"error_message": "The provided salt isn't a base64 encoded string. Please base64 encode the salt before passing it to this endpoint.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_base64_scrypt_salt"
}invalid_bcrypt_cost
400Bad request
The bcrypt cost value is too high, it must be less than 15. If you need a higher cost parameter, please email support@stytch.com.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_bcrypt_cost",
"error_message": "The bcrypt cost value is too high, it must be less than 15. If you need a higher cost parameter, please email support@stytch.com.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_bcrypt_cost"
}invalid_bcrypt_hash
400Bad request
The bcrypt hash passed is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_bcrypt_hash",
"error_message": "The bcrypt hash passed is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_bcrypt_hash"
}invalid_biometric_registration_id
400Bad request
biometric_registration_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_biometric_registration_id",
"error_message": "biometric_registration_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_biometric_registration_id"
}invalid_callback_id
400Bad request
The callback URL has an invalid OAuth Callback ID. Please find it in the dashboard at https://stytch.com/dashboard/ and follow the steps there to enter it into the identity provider
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_callback_id",
"error_message": "The callback URL has an invalid OAuth Callback ID. Please find it in the dashboard at https://stytch.com/dashboard/ and follow the steps there to enter it into the identity provider",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_callback_id"
}invalid_captcha_provider_id
400Bad request
captcha_provider_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_captcha_provider_id",
"error_message": "captcha_provider_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_captcha_provider_id"
}invalid_captcha_provider_type
400Bad request
provider_type should be set to 'GoogleRecaptchaEnterpriseSilentWeb', 'GoogleRecaptchaEnterpriseSilentAndroid', or 'GoogleRecaptchaEnterpriseSilentIOS',.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_captcha_provider_type",
"error_message": "provider_type should be set to 'GoogleRecaptchaEnterpriseSilentWeb', 'GoogleRecaptchaEnterpriseSilentAndroid', or 'GoogleRecaptchaEnterpriseSilentIOS',.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_captcha_provider_type"
}invalid_captcha_threshold
400Bad request
threshold should be in the range 0 to 1 inclusive.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_captcha_threshold",
"error_message": "threshold should be in the range 0 to 1 inclusive.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_captcha_threshold"
}invalid_code
400Bad request
Code format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_code",
"error_message": "Code format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_code"
}invalid_create_user_request
400Bad request
Invalid CreateUser request. Please provide either an email or phone_number in the request.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_create_user_request",
"error_message": "Invalid CreateUser request. Please provide either an email or phone_number in the request.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_create_user_request"
}invalid_crypto_wallet_id
400Bad request
The crypto_wallet_id is invalid (i.e. not properly formatted) or missing. crypto-wallet-test-dbbd372e-79f8-48ea-907c-5f0755e7d328 is an example crypto_wallet_id.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_crypto_wallet_id",
"error_message": "crypto_wallet_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_crypto_wallet_id"
}invalid_default_url
400Bad request
Thanks for trying Stytch! Replace the default URL with your own to get started. If you haven't already done so, you'll also need to set your magic_link_urls in the dashboard here: https://stytch.com/dashboard/redirect-urls
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_default_url",
"error_message": "Thanks for trying Stytch! Replace the default URL with your own to get started. If you haven't already done so, you'll also need to set your magic_link_urls in the dashboard here: https://stytch.com/dashboard/redirect-urls",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_default_url"
}invalid_domain
400Bad request
Invalid domain, ensure that only the domain was provided. Do not include https:// or a port in this value. Visit the link here for more information about valid domains (called RP ID on the site).
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_domain",
"error_message": "Invalid domain, ensure that only the domain was provided. Do not include https:// or a port in this value. Visit https://w3c.github.io/webauthn/#rp-id for more information about valid domains (called RP ID on the site).",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_domain"
}invalid_email
400Bad request
The email address is invalid (i.e. not properly formatted) or missing. Check that the email address is properly formatted and only includes allowed characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email",
"error_message": "Email format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email"
}invalid_email_html
400Bad request
email html is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email_html",
"error_message": "email html is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email_html"
}invalid_email_id
400Bad request
The email_id is invalid (i.e. not properly formatted) or missing. email-test-81bf03a8-86e1-4d95-bd44-bb3495224953 is an example email_id.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email_id",
"error_message": "email_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email_id"
}invalid_email_plaintext
400Bad request
email plaintext is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email_plaintext",
"error_message": "email plaintext is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email_plaintext"
}invalid_email_sandbox
400Bad request
Invalid email. The sanbox@stytch.com email can only be used in the Test environment.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email_sandbox",
"error_message": "Invalid email. The sanbox@stytch.com email can only be used in the Test environment.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email_sandbox"
}invalid_email_subject
400Bad request
email subject is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email_subject",
"error_message": "email subject is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email_subject"
}invalid_ethereum_address
400Bad request
crypto_wallet_address format is invalid for an Ethereum address. Expecting a string starting with 0x followed by 40 hexadecimal characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_ethereum_address",
"error_message": "crypto_wallet_address format is invalid for an Ethereum address. Expecting a string starting with 0x followed by 40 hexadecimal characters.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_ethereum_address"
}invalid_exchange_primary_factor_fields
400Bad request
Please ensure exactly one of the following is provided: email_address, phone_number.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_exchange_primary_factor_fields",
"error_message": "Please ensure exactly one of the following is provided: email_address, phone_number.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_exchange_primary_factor_fields"
}invalid_exchange_primary_factor_user
400Bad request
The provided user does not have exactly one factor that's either an email or a phone.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_exchange_primary_factor_user",
"error_message": "The provided user does not have exactly one factor that's either an email or a phone.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_exchange_primary_factor_user"
}invalid_expiration
400Bad request
Expiration is invalid, should be between 5 and 10080 minutes.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_expiration",
"error_message": "Expiration is invalid, should be between 5 and 10080 minutes.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_expiration"
}invalid_expiration_otp
400Bad request
expiration_minutes is invalid, should be between 1 and 10 minutes.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_expiration_otp",
"error_message": "expiration_minutes is invalid, should be between 1 and 10 minutes.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_expiration_otp"
}invalid_hash
400Bad request
hash is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_hash",
"error_message": "hash is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_hash"
}invalid_hash_type
400Bad request
The hash_type is invalid. Please check here for a list of supported hash types.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_hash_type",
"error_message": "hash_type is invalid. Please check https://stytch.com/docs/api/password-migrate for a list of support hash types.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_hash_type"
}invalid_id
400Bad request
ID format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_id",
"error_message": "ID format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_id"
}invalid_invite_magic_link_url
400Bad request
invite_magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_invite_magic_link_url",
"error_message": "invite_magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_invite_magic_link_url"
}invalid_invite_redirect_url
400Bad request
invite_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_invite_redirect_url",
"error_message": "invite_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_invite_redirect_url"
}invalid_ip_address
400Bad request
ip_address format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_ip_address",
"error_message": "ip_address format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_ip_address"
}invalid_locale
400Bad request
locale is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_locale",
"error_message": "locale is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_locale"
}invalid_login_magic_link_url
400Bad request
login_magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_login_magic_link_url",
"error_message": "login_magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_login_magic_link_url"
}invalid_login_redirect_url
400Bad request
login_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_login_redirect_url",
"error_message": "login_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_login_redirect_url"
}invalid_m2m_client_scope
400Bad request
The client scope was invalid. Client scopes must be at most 128 characters long and must not contain spaces, backslashes, or quotes.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_m2m_client_scope",
"error_message": "The client scope was invalid. Client scopes must be at most 128 characters long and must not contain spaces, backslashes, or quotes.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_m2m_client_scope"
}invalid_m2m_client_status
400Bad request
The client status sent was invalid. Client statuses must be either 'active' or 'disabled'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_m2m_client_status",
"error_message": "The client status sent was invalid. Client statuses must be either 'active' or 'disabled'.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_m2m_client_status"
}invalid_magic_link_url
400Bad request
magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_magic_link_url",
"error_message": "magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_magic_link_url"
}invalid_md_5_hash
400Bad request
The MD5 hash passed is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_md_5_hash",
"error_message": "The MD5 hash passed is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_md_5_hash"
}invalid_method_id
400Bad request
The method_id is invalid (i.e. not properly formatted) or missing. email-test-81bf03a8-86e1-4d95-bd44-bb3495224953 is an example method_id.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_method_id",
"error_message": "method_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_method_id"
}invalid_oauth_attach_token
400Bad request
The OAuth attach token could not be matched.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_oauth_attach_token",
"error_message": "The OAuth attach token could not be matched.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_oauth_attach_token"
}invalid_oauth_provider
400Bad request
We didn't recognize the OAuth provider name in the request. Check that the argument is the name of a supported OAuth provider.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_oauth_provider",
"error_message": "We didn't recognize the OAuth provider name in the request. Check that the argument is the name of a supported OAuth provider.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_oauth_provider"
}invalid_oauth_user_registration_id
400Bad request
oauth_user_registration_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_oauth_user_registration_id",
"error_message": "oauth_user_registration_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_oauth_user_registration_id"
}invalid_organization_id
400Bad request
organization_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_organization_id",
"error_message": "organization_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_organization_id"
}invalid_organization_name
400Bad request
Organization name cannot be longer than 128 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_organization_name",
"error_message": "Organization name cannot be longer than 128 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_organization_name"
}invalid_password_id
400Bad request
password_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_password_id",
"error_message": "password_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_password_id"
}invalid_password_reset_redirect_url
400Bad request
reset_password_redirect_url is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_password_reset_redirect_url",
"error_message": "reset_password_redirect_url is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_password_reset_redirect_url"
}invalid_pbkdf_2_hash
400Bad request
The PBKDF-2 hash passed is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_pbkdf_2_hash",
"error_message": "The PBKDF-2 hash passed is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pbkdf_2_hash"
}invalid_pbkdf_2_iteration_amount
400Bad request
The provided PBKDF-2 iteration_amount value is invalid. Valid range: 512-524288.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_pbkdf_2_iteration_amount",
"error_message": "The provided PBKDF-2 iteration_amount value is invalid. Valid range: 512-524288.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pbkdf_2_iteration_amount"
}invalid_pbkdf_2_key_length
400Bad request
The provided PBKDF-2 key_length is invalid. Valid range: 8-2048.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_pbkdf_2_key_length",
"error_message": "The provided PBKDF-2 key_length is invalid. Valid range: 8-2048.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pbkdf_2_key_length"
}invalid_pbkdf_2_salt
400Bad request
The provided PBKDF-2 salt is missing or an invalid length.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_pbkdf_2_salt",
"error_message": "The provided PBKDF-2 salt is missing or an invalid length.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pbkdf_2_salt"
}invalid_phone_number
400Bad request
The phone number is invalid, i.e. not properly formatted, or missing.
Common causes
If you’re accepting the raw input from a user, they may have included an invalid character, i.e. not a digit.
If the phone number is missing from the call, you may not be passing the input from the user to your backend.
[WhatsApp] Meta blocks the delivery of WhatsApp OTP messages to phone numbers from India (+91) - a +91 phone number supplied to our WhatsApp OTP endpoints will result in an invalid_phone_number error.
[WhatsApp] Recipient has not accepted WhatsApp's new Terms of Service, or is using an unsupported version of the WhatsApp client for their phone.
Troubleshooting steps
If you’re accepting the raw input form a user, make sure you’re sanitizing the input and formatting it properly. Many libraries can help with this, like libphonenumber-js.
Check that the phone number is properly formatted with the E. 164 format, e.g. “+14155551234”
Check that the phone number only includes allowed characters, i.e. dashes “555-1234” and parentheses “(415)” are not included.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_phone_number",
"error_message": "Phone number format is invalid. Ensure the phone number is in the E.164 format.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_phone_number"
}invalid_phone_number_country_code
400Bad request
The phone number's country code is invalid or not supported.
Common causes
SMS to phone numbers outside of the US and Canada is disabled by default for customers who did not use SMS prior to October 2023. If you're interested in sending international SMS, please reach out to support@stytch.com.
Regardless of whether or not you are enabled for international SMS, Stytch does not support sending SMS to countries on our Unsupported countries list.
Troubleshooting steps
Make sure that the country code you've provided is correctly formatted.
Make sure that the country is not included in our Unsupported countries list.
Make sure that your Stytch workspace is enabled for SMS to international numbers by reaching out to support@stytch.com.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_phone_number_country_code",
"error_message": "The phone number's country code is invalid, unsupported, or disabled for your Stytch Workspace. Please see here for additional information: https://stytch.com/docs/api/errors/400#invalid_phone_number_country_code",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_phone_number_country_code"
}invalid_phone_number_docs
400Bad request
Thanks for trying Stytch! Replace the test phone number with a valid one to start sending one-time passcodes.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_phone_number_docs",
"error_message": "Thanks for trying Stytch! Replace the test phone number with a valid one to start sending one-time passcodes.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_phone_number_docs"
}invalid_phone_number_sandbox
400Bad request
Phone number is invalid. The sandbox phone number, +10000000000, can only be used in the Test environment.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_phone_number_sandbox",
"error_message": "Phone number is invalid. The sandbox phone number, +10000000000, can only be used in the Test environment.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_phone_number_sandbox"
}invalid_phpass_hash_format
400Bad request
The phpass hash has an incorrect format as it needs to be exactly 34 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_phpass_hash_format",
"error_message": "The phpass hash has an incorrect format as it needs to be exactly 34 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_phpass_hash_format"
}invalid_phpass_hash_prefix
400Bad request
The phpass hash is invalid as it needs to start with $P$
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_phpass_hash_prefix",
"error_message": "The phpass hash is invalid as it needs to start with $P$",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_phpass_hash_prefix"
}invalid_pkce_code_challenge
400Bad request
The PKCE Code Challenge param may only contain alphanumerics and the reserved characters '-', '.', '_', or '~'. It must also be between 43 and 128 characters long. Please refer to https://datatracker.ietf.org/doc/html/rfc7636#section-4.2 for details.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_pkce_code_challenge",
"error_message": "The PKCE Code Challenge param may only contain alphanumerics and the reserved characters '-', '.', '_', or '~'. It must also be between 43 and 128 characters long. Please refer to https://datatracker.ietf.org/doc/html/rfc7636#section-4.2 for details.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pkce_code_challenge"
}invalid_pkce_code_verifier
400Bad request
The PKCE Code Verifier param may only contain alphanumerics and the reserved characters '-', '.', '_', or '~'. It must also be between 43 and 128 characters long. Please refer to https://datatracker.ietf.org/doc/html/rfc7636#section-4.1 for details.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_pkce_code_verifier",
"error_message": "The PKCE Code Verifier param may only contain alphanumerics and the reserved characters '-', '.', '_', or '~'. It must also be between 43 and 128 characters long. Please refer to https://datatracker.ietf.org/doc/html/rfc7636#section-4.1 for details.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pkce_code_verifier"
}invalid_prepend_salt
400Bad request
The prepend_salt value is not supported because it's too long.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_prepend_salt",
"error_message": "The prepend_salt value is not supported because it's too long.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_prepend_salt"
}invalid_project_id
400Bad request
project_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_project_id",
"error_message": "project_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_project_id"
}invalid_project_id_authentication
400Bad request
The project ID provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To view your project ID please visit the Stytch dashboard here.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_project_id_authentication",
"error_message": "The project ID provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To create a new project or confirm an existing project ID please visit the Stytch dashboard here: https://stytch.com/dashboard/api-keys",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_project_id_authentication"
}invalid_public_key
400Bad request
Invalid public key. The key is present but is malformed and cannot be decoded. The field should be base64 encoded.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key",
"error_message": "Invalid public key. The key is present but is malformed and cannot be decoded. The field should be base64 encoded.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key"
}invalid_public_key_credential
400Bad request
Invalid public key credential. Please confirm you're passing a correctly formatted public key credential.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential",
"error_message": "Invalid public key credential. Please confirm you're passing a correctly formatted public key credential.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential"
}invalid_public_key_credential_invalid_authenticator_data
400Bad request
Invalid public key credential. The authenticatorData field is present but is malformed and cannot be decoded. The field should be base64 encoded.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_invalid_authenticator_data",
"error_message": "Invalid public key credential. The authenticatorData field is present but is malformed and cannot be decoded. The field should be base64 encoded.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_invalid_authenticator_data"
}invalid_public_key_credential_invalid_id
400Bad request
Invalid public key credential. The id field is present but is malformed and cannot be decoded. The field should be base64 encoded.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_invalid_id",
"error_message": "Invalid public key credential. The id field is present but is malformed and cannot be decoded. The field should be base64 encoded.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_invalid_id"
}invalid_public_key_credential_invalid_signature
400Bad request
Invalid public key credential. The signature field is present but is malformed and cannot be decoded. The field should be base64 encoded.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_invalid_signature",
"error_message": "Invalid public key credential. The signature field is present but is malformed and cannot be decoded. The field should be base64 encoded.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_invalid_signature"
}invalid_public_key_credential_malformed_attestation_object
400Bad request
Invalid public key credential. The attestationObject field is present but is malformed and cannot be parsed.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_malformed_attestation_object",
"error_message": "Invalid public key credential. The attestationObject field is present but is malformed and cannot be parsed.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_malformed_attestation_object"
}invalid_public_key_credential_malformed_client_data_json
400Bad request
Invalid public key credential. The clientDataJSON field is present but is malformed and cannot be parsed.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_malformed_client_data_json",
"error_message": "Invalid public key credential. The clientDataJSON field is present but is malformed and cannot be parsed.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_malformed_client_data_json"
}invalid_public_key_credential_missing_attestation_object_field
400Bad request
Invalid public key credential. The public key credential is missing the attestationObject field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_missing_attestation_object_field",
"error_message": "Invalid public key credential. The public key credential is missing the attestationObject field.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_missing_attestation_object_field"
}invalid_public_key_credential_missing_authenticator_data_field
400Bad request
Invalid public key credential. The public key credential is missing the authenticatorData field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_missing_authenticator_data_field",
"error_message": "Invalid public key credential. The public key credential is missing the authenticatorData field.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_missing_authenticator_data_field"
}invalid_public_key_credential_missing_client_data_json_field
400Bad request
Invalid public key credential. The public key credential is missing the clientDataJSON field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_missing_client_data_json_field",
"error_message": "Invalid public key credential. The public key credential is missing the clientDataJSON field.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_missing_client_data_json_field"
}invalid_public_key_credential_missing_id_field
400Bad request
Invalid public key credential. The public key credential is missing an id field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_missing_id_field",
"error_message": "Invalid public key credential. The public key credential is missing an id field.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_missing_id_field"
}invalid_public_key_credential_missing_response_field
400Bad request
Invalid public key credential. The public key credential is missing the response field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_missing_response_field",
"error_message": "Invalid public key credential. The public key credential is missing the response field.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_missing_response_field"
}invalid_public_key_credential_missing_signature_field
400Bad request
Invalid public key credential. The public key credential is missing the signature field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_key_credential_missing_signature_field",
"error_message": "Invalid public key credential. The public key credential is missing the signature field.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_key_credential_missing_signature_field"
}invalid_public_token_id
400Bad request
The public_token used to instantiate the Stytch SDK is invalid. You can find your public_token in the API keys section of the Stytch Dashboard.
Common causes
No public_token was passed in when loading the Stytch SDK.
The public_token passed was invalid, e.g. it contains quotes, was of an incorrect length or format, etc.
Troubleshooting steps
Check that your environment contains your Stytch public_token.
Check that you’re passing the public_token in via the correct method. You can see how to launch each Stytch SDK by visiting their respective Docs.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_public_token_id",
"error_message": "public_token_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_public_token_id"
}invalid_recovery_code
400Bad request
The recovery_code submitted was invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_recovery_code",
"error_message": "The recovery_code submitted was invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_recovery_code"
}invalid_redirect_url_type
400Bad request
Invalid redirect URL Type. Type should be login, invite, signup, reset_password, or discovery. Only B2B projects can pass discovery.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_redirect_url_type",
"error_message": "Invalid redirect URL Type. Type should be login, invite, signup, reset_password, or discovery. Only B2B projects can pass discovery.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_redirect_url_type"
}invalid_request
400Bad request
Invalid request. Ensure that your project ID exists is passed into the URI path.
Common causes
There was a missing project_id parameter, or the project was not found.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error": "invalid_request",
"error_description": "Invalid request. Ensure that your project ID exists is passed into the URI path.",
"error_uri": "https://stytch.com/docs/api/errors/400#invalid_request"
}invalid_request_id
400Bad request
request_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_request_id",
"error_message": "request_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_request_id"
}invalid_request_value
400Bad request
Invalid request value, request is required and must have a value.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_request_value",
"error_message": "Invalid request value, request is required and must have a value.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_request_value"
}invalid_role
400Bad request
Role specified is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_role",
"error_message": "Role specified is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_role"
}invalid_scope
400Bad request
Please make sure that the scopes requested are included in the client.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error": "invalid_scope",
"error_description": "Please make sure that the scopes requested are included in the client.",
"error_uri": "https://stytch.com/docs/api/errors/400#invalid_scope"
}invalid_scope_parameter
400Bad request
scopes is not a recognized parameter. Please use scope instead.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error": "invalid_scope_parameter",
"error_description": "`scopes` is not a recognized parameter. Please use `scope` instead.",
"error_uri": "https://stytch.com/docs/api/errors/400#invalid_scope_parameter"
}invalid_scrypt_n_parameter
400Bad request
The n parameter is invalid. It needs to be greater than 1, a power of 2, and less than or equal to 262,144. If you need a higher n parameter, please email support@stytch.com.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_scrypt_n_parameter",
"error_message": "The n parameter is invalid. It needs to be greater than 1, a power of 2, and less than or equal to 262,144. If you need a higher n parameter, please email support@stytch.com.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_scrypt_n_parameter"
}invalid_scrypt_parameters
400Bad request
The scrypt parameters are too large. The r parameter multipled by p parameter must be under 2 raised to the 30th power (r * p < 2^30).
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_scrypt_parameters",
"error_message": "The scrypt parameters are too large. The r parameter multipled by p parameter must be under 2 raised to the 30th power (r * p < 2^30).",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_scrypt_parameters"
}invalid_scrypt_salt_length
400Bad request
The salt value is an unsupported length.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_scrypt_salt_length",
"error_message": "The salt value is an unsupported length.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_scrypt_salt_length"
}invalid_secret_authentication
400Bad request
The secret provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To create a new secret for your project or to confirm an existing secret please visit the Stytch dashboard here.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_secret_authentication",
"error_message": "The secret provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To create a new secret for your project or to confirm an existing secret please visit the Stytch dashboard here: https://stytch.com/dashboard/api-keys",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_secret_authentication"
}invalid_secret_id
400Bad request
secret_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_secret_id",
"error_message": "secret_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_secret_id"
}invalid_session_duration_minutes
400Bad request
session_duration_minutes is invalid, should be between 5 to 527040 minutes.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_session_duration_minutes",
"error_message": "session_duration_minutes is invalid, should be between 5 to 527040 minutes.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_session_duration_minutes"
}invalid_session_id
400Bad request
session_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_session_id",
"error_message": "session_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_session_id"
}invalid_session_management
400Bad request
session_management_type should be set to 'none', 'idp', or 'stytch'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_session_management",
"error_message": "session_management_type should be set to 'none', 'idp', or 'stytch'.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_session_management"
}invalid_session_missing_primary_factor
400Bad request
Cannot create a new session without primary factors.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_session_missing_primary_factor",
"error_message": "Cannot create a new session without primary factors.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_session_missing_primary_factor"
}invalid_session_token
400Bad request
The session_token format is invalid (i.e. not properly formatted). Stytch will return this error if the session_token or session_jwt is invalid, e.g. malformed, too few characters, too many etc.
Common causes
Your backend or frontend is not properly parsing the session value from where you are storing it, e.g. you’re parsing and passing the key and value instead of just the value.
You are running automated tests with a placeholder value, e.g. “test-123”, for sessions against our API.
Troubleshooting steps
Double check your parsing logic for pulling the session_token or session_jwt. Make sure that you are only pulling the value itself and preserving the full length of each.
session_tokens are 44 characters long and may include numbers, letters, and special characters.
session_jwts can be arbitrarily long depending upon their contents, and conform to RFC 7519.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_session_token",
"error_message": "Session token format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_session_token"
}invalid_session_token_docs
400Bad request
The session_token you provided is a sample one from the Docs. Please use a session_token that you received from a /sessions/authenticate request.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_session_token_docs",
"error_message": "The session_token you provided is a sample one from the Docs. Please use a session_token that you received from a /sessions/authenticate request.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_session_token_docs"
}invalid_sha_1_hash
400Bad request
The SHA-1 hash passed is not valid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_sha_1_hash",
"error_message": "The SHA-1 hash passed is not valid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_sha_1_hash"
}invalid_signature
400Bad request
signature is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_signature",
"error_message": "signature is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_signature"
}invalid_signup_magic_link_url
400Bad request
signup_magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_signup_magic_link_url",
"error_message": "signup_magic_link_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_signup_magic_link_url"
}invalid_signup_redirect_url
400Bad request
signup_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_signup_redirect_url",
"error_message": "signup_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_signup_redirect_url"
}invalid_solana_address
400Bad request
crypto_wallet_address format is invalid for an Solana address. Expecting a 32 or 44 character base58 string.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_solana_address",
"error_message": "crypto_wallet_address format is invalid for an Solana address. Expecting a 32 or 44 character base58 string.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_solana_address"
}invalid_subject
400Bad request
The subject provided is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_subject",
"error_message": "The subject provided is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_subject"
}invalid_template_id
400Bad request
template_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_template_id",
"error_message": "template_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_template_id"
}invalid_template_values
400Bad request
template_values must only consist of string keys that map to string values.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_template_values",
"error_message": "template_values must only consist of string keys that map to string values.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_template_values"
}invalid_token
400Bad request
Token format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_token",
"error_message": "Token format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_token"
}invalid_token_docs
400Bad request
Thanks for trying Stytch! Replace the test token with a valid one found in a Stytch email to start authenticating users.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_token_docs",
"error_message": "Thanks for trying Stytch! Replace the test token with a valid one found in a Stytch email to start authenticating users.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_token_docs"
}invalid_totp_code
400Bad request
The totp_code submitted was invalid. The totp_code must be 6 digits long.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_totp_code",
"error_message": "The totp_code submitted was invalid. The totp_code must be 6 digits long.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_totp_code"
}invalid_totp_id
400Bad request
totp_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_totp_id",
"error_message": "totp_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_totp_id"
}invalid_url
400Bad request
URL format is invalid. Common issues include using http instead of https or omitting https://. If including query parameters use {} as a placeholder value. For example: https://example.com/authenticate?redirect={}
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_url",
"error_message": "URL format is invalid. Common issues include using http instead of https or omitting https://. If including query parameters use {} as a placeholder value. For example: https://example.com/authenticate?redirect={}",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_url"
}invalid_user_agent
400Bad request
user_agent format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_user_agent",
"error_message": "user_agent format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_user_agent"
}invalid_user_id
400Bad request
The user_id is invalid (i.e. not properly formatted) or missing. user-test-16d9ba61-97a1-4ba4-9720-b03761dc50c6 is an example user_id.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_user_id",
"error_message": "user_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_user_id"
}invalid_wallet_address_user
400Bad request
The passed crypto_wallet_address belongs to a different user than the user_id provided.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_wallet_address_user",
"error_message": "The passed crypto_wallet_address belongs to a different user than the user_id provided.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_wallet_address_user"
}invalid_wallet_type
400Bad request
crypto_wallet_type is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_wallet_type",
"error_message": "crypto_wallet_type is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_wallet_type"
}invalid_webauthn_registration_domain
400Bad request
The domain cannot be longer than 255 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_webauthn_registration_domain",
"error_message": "The domain cannot be longer than 255 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_webauthn_registration_domain"
}invalid_webauthn_registration_id
400Bad request
webauthn_registration_id format is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_webauthn_registration_id",
"error_message": "webauthn_registration_id format is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_webauthn_registration_id"
}jwt_template_invalid_json
400Bad request
JWT Template did not produce valid JSON output.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "jwt_template_invalid_json",
"error_message": "JWT Template did not produce valid JSON output.",
"error_url": "https://stytch.com/docs/api/errors/400#jwt_template_invalid_json"
}jwt_template_invalid_tag
400Bad request
JWT Template contains an invalid tag.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "jwt_template_invalid_tag",
"error_message": "JWT Template contains an invalid tag.",
"error_url": "https://stytch.com/docs/api/errors/400#jwt_template_invalid_tag"
}jwt_template_mismatched_tag
400Bad request
JWT Template contains a mismatched set of tags.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "jwt_template_mismatched_tag",
"error_message": "JWT Template contains a mismatched set of tags.",
"error_url": "https://stytch.com/docs/api/errors/400#jwt_template_mismatched_tag"
}jwt_template_not_found
400Bad request
JWT Template was not found.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "jwt_template_not_found",
"error_message": "JWT Template was not found.",
"error_url": "https://stytch.com/docs/api/errors/400#jwt_template_not_found"
}live_id_used_in_test_environment
400Bad request
Invalid argument sent to Test environment. Looks like you supplied a Live identifier for a request for the Test environment (test.stytch.com). Try sending a request to api.stytch.com instead or using a different identifier.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "live_id_used_in_test_environment",
"error_message": "Invalid argument sent to Test environment. Looks like you supplied a Live identifier for a request for the Test environment (test.stytch.com). Try sending a request to api.stytch.com instead or using a different identifier.",
"error_url": "https://stytch.com/docs/api/errors/400#live_id_used_in_test_environment"
}m2m_client_already_rotating_secret
400Bad request
The client is already in a secret rotation flow. Please finish or cancel the current secret rotation flow before starting a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_already_rotating_secret",
"error_message": "The client is already in a secret rotation flow. Please finish or cancel the current secret rotation flow before starting a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_already_rotating_secret"
}m2m_client_invalid_client_description
400Bad request
M2M Client Description may not be larger than 512 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_invalid_client_description",
"error_message": "M2M Client Description may not be larger than 512 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_invalid_client_description"
}m2m_client_invalid_client_id
400Bad request
M2M Client ID may not be larger than 128 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_invalid_client_id",
"error_message": "M2M Client ID may not be larger than 128 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_invalid_client_id"
}m2m_client_invalid_client_name
400Bad request
M2M Client Name may not be larger than 128 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_invalid_client_name",
"error_message": "M2M Client Name may not be larger than 128 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_invalid_client_name"
}m2m_client_invalid_client_secret
400Bad request
M2M Client Secret may not be larger than 128 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_invalid_client_secret",
"error_message": "M2M Client Secret may not be larger than 128 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_invalid_client_secret"
}m2m_client_invalid_status
400Bad request
M2M Client status must be either 'active' or 'inactive'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_invalid_status",
"error_message": "M2M Client status must be either 'active' or 'inactive'.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_invalid_status"
}m2m_client_not_found
400Bad request
The m2m client requested could not be found.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_not_found",
"error_message": "The m2m client requested could not be found.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_not_found"
}m2m_client_not_rotating_secret
400Bad request
The client is not in a secret rotation flow. Please start a secret rotation flow before calling this endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_client_not_rotating_secret",
"error_message": "The client is not in a secret rotation flow. Please start a secret rotation flow before calling this endpoint.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_client_not_rotating_secret"
}m2m_search_expected_array_of_strings
400Bad request
Expected m2m search filter_value to contain an array of strings.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_search_expected_array_of_strings",
"error_message": "Expected m2m search filter_value to contain an array of strings.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_search_expected_array_of_strings"
}m2m_search_filter_name_must_be_string
400Bad request
Expected m2m search operand 'filter_name' to be a string.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_search_filter_name_must_be_string",
"error_message": "Expected m2m search operand 'filter_name' to be a string.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_search_filter_name_must_be_string"
}m2m_search_filter_name_not_recognized
400Bad request
The m2m search operand filter name was not recognized.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_search_filter_name_not_recognized",
"error_message": "The m2m search operand filter name was not recognized.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_search_filter_name_not_recognized"
}m2m_search_missing_filter_name
400Bad request
Expected m2m search operand to contain a 'filter_name' key.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_search_missing_filter_name",
"error_message": "Expected m2m search operand to contain a 'filter_name' key.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_search_missing_filter_name"
}m2m_search_missing_filter_value
400Bad request
Expected m2m search operand to contain a filter_value key.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "m2m_search_missing_filter_value",
"error_message": "Expected m2m search operand to contain a filter_value key.",
"error_url": "https://stytch.com/docs/api/errors/400#m2m_search_missing_filter_value"
}missing_apple_app_id
400Bad request
The Apple OAuth config is missing an App ID value.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "missing_apple_app_id",
"error_message": "The Apple OAuth config is missing an App ID value.",
"error_url": "https://stytch.com/docs/api/errors/400#missing_apple_app_id"
}missing_sms_parameter
400Bad request
One or more of the parameters in the custom SMS request could not be found.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "missing_sms_parameter",
"error_message": "One or more of the parameters in the custom SMS request could not be found.",
"error_url": "https://stytch.com/docs/api/errors/400#missing_sms_parameter"
}no_active_biometric_registrations
400Bad request
No active mobile biometric registrations were found.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_active_biometric_registrations",
"error_message": "No active mobile biometric registrations were found.",
"error_url": "https://stytch.com/docs/api/errors/400#no_active_biometric_registrations"
}no_active_webauthn_registrations
400Bad request
No active WebAuthn registrations for this user ID and domain. To create one, first hit the WebAuthn register/start endpoint. Complete the registration by subsequently hitting the WebAuthn register endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_active_webauthn_registrations",
"error_message": "No active WebAuthn registrations for this user ID and domain. To create one, first hit the WebAuthn register/start endpointwith the supplied user ID and domain: https://stytch.com/docs/api/webauthn-register-start. Complete the registration by subsequently hitting the WebAuthn register endpoint: https://stytch.com/docs/api/webauthn-register.",
"error_url": "https://stytch.com/docs/api/errors/400#no_active_webauthn_registrations"
}no_associated_session_passed_in
400Bad request
A session was passed in on the /send request but not on this request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_associated_session_passed_in",
"error_message": "A session was passed in on the /send request but not on this request",
"error_url": "https://stytch.com/docs/api/errors/400#no_associated_session_passed_in"
}no_default_discovery_redirect_url_set
400Bad request
There is no default discovery redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a discovery redirect URL in the request or set a default for this project. To set discovery redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_default_discovery_redirect_url_set",
"error_message": "There is no default discovery redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a discovery redirect URL in the request or set a default for this project. To set discovery redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls",
"error_url": "https://stytch.com/docs/api/errors/400#no_default_discovery_redirect_url_set"
}no_default_invite_redirect_url_set
400Bad request
There is no default invite redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a invite redirect URL in the request or set a default for this project. To set invite redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_default_invite_redirect_url_set",
"error_message": "There is no default invite redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a invite redirect URL in the request or set a default for this project. To set invite redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls",
"error_url": "https://stytch.com/docs/api/errors/400#no_default_invite_redirect_url_set"
}no_default_login_redirect_url_set
400Bad request
There is no default login redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a login redirect URL in the request or set a default for this project. To set login redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_default_login_redirect_url_set",
"error_message": "There is no default login redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a login redirect URL in the request or set a default for this project. To set login redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls",
"error_url": "https://stytch.com/docs/api/errors/400#no_default_login_redirect_url_set"
}no_default_signup_redirect_url_set
400Bad request
There is no default signup redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a signup redirect URL in the request or set a default for this project. To set signup redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_default_signup_redirect_url_set",
"error_message": "There is no default signup redirect URLs set for this project, so we are unable to redirect the user to the application. Please include a signup redirect URL in the request or set a default for this project. To set signup redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls",
"error_url": "https://stytch.com/docs/api/errors/400#no_default_signup_redirect_url_set"
}no_invite_redirect_url
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_invite_redirect_url",
"error_message": "There are no invite redirect URLs registered. To set invite redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation.",
"error_url": "https://stytch.com/docs/api/errors/400#no_invite_redirect_url"
}no_invite_redirect_urls_set
400Bad request
Unable to verify the provided invite_magic_link_url. There are no invite redirect URLs set for this project so we are unable to verify the invite_magic_link_url provided in the request. To set invite redirect URLs for the project please visit the dashboard here. For more information on why this validation is necessary please read more here.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_invite_redirect_urls_set",
"error_message": "Unable to verify the provided invite_magic_link_url. There are no invite redirect URLs set for this project so we are unable to verify the invite_magic_link_url provided in the request. To set invite redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#no_invite_redirect_urls_set"
}no_login_redirect_url
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_login_redirect_url",
"error_message": "There are no login redirect URLs registered. To set login redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation.",
"error_url": "https://stytch.com/docs/api/errors/400#no_login_redirect_url"
}no_login_redirect_urls_set
400Bad request
Unable to verify the provided login_magic_link_url. There are no login redirect URLs set for this project so we are unable to verify the login_magic_link_url provided in the request. To set login redirect URLs for the project please visit the dashboard here. For more information on why this validation is necessary please read more here.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_login_redirect_urls_set",
"error_message": "Unable to verify the provided login_magic_link_url. There are no login redirect URLs set for this project so we are unable to verify the login_magic_link_url provided in the request. To set login redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#no_login_redirect_urls_set"
}no_match_for_provided_magic_link_url
400Bad request
The magic_link_url in the request did not match any redirect URLs set for the project. Please visit the Stytch dashboard here to update the redirect URLs for the project. For more information on why this validation is necessary please read more here.
Common causes
The provided magic_link_url was not added to the Stytch dashboard
The provided magic_link_url contents were changed during development, and the Stytch dashboard was not updated accordingly
Troubleshooting steps
Compare provided magic_link_url with values in the dashboard
Be sure magic_link_url is a redirect URL in the Stytch environment you are using. The Test and Live redirect urls are configured separately with the dashboard.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_match_for_provided_magic_link_url",
"error_message": "The magic_link_url in the request did not match any redirect URLs set for this project. Please visit https://stytch.com/dashboard/redirect-urls to update the redirect URLs for this project. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#no_match_for_provided_magic_link_url"
}no_match_for_provided_oauth_url
400Bad request
The sso redirect url in the request did not match any redirect URLs set for this project. Please visit https://stytch.com/dashboard/redirect-urls to update the redirect URLs for this project. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_match_for_provided_oauth_url",
"error_message": "The sso redirect url in the request did not match any redirect URLs set for this project. Please visit https://stytch.com/dashboard/redirect-urls to update the redirect URLs for this project. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#no_match_for_provided_oauth_url"
}no_match_for_provided_sso_url
400Bad request
The oauth redirect url in the request did not match any redirect URLs set for this project. Please visit https://stytch.com/dashboard/redirect-urls to update the redirect URLs for this project. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_match_for_provided_sso_url",
"error_message": "The oauth redirect url in the request did not match any redirect URLs set for this project. Please visit https://stytch.com/dashboard/redirect-urls to update the redirect URLs for this project. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#no_match_for_provided_sso_url"
}no_password_reset_redirect_url
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_password_reset_redirect_url",
"error_message": "Unable to verify the provided reset_password_redirect_url. There are no password reset redirect URLs set for this project so we are unable to verify the reset_password_redirect_url provided in the request. To set password reset redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation.",
"error_url": "https://stytch.com/docs/api/errors/400#no_password_reset_redirect_url"
}no_pending_webauthn_registration
400Bad request
Unable to find a pending registration tied to this user. Please ensure you've first hit the WebAuthn register/start endpoint with the supplied user_id.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_pending_webauthn_registration",
"error_message": "Unable to find a pending registration tied to this user. Please ensure you've first hit the WebAuthn register/start endpoint with the supplied user ID: https://stytch.com/docs/api/webauthn-register-start.",
"error_url": "https://stytch.com/docs/api/errors/400#no_pending_webauthn_registration"
}no_session_arguments
400Bad request
Please ensure you're passing exactly one session field.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_session_arguments",
"error_message": "Please ensure you're passing exactly one session field.",
"error_url": "https://stytch.com/docs/api/errors/400#no_session_arguments"
}no_session_revoke_arguments
400Bad request
Please include a session_id, session_token, session_jwt, or a member_id (if the project is a B2B project). Exactly one of those values is required to revoke a session.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_session_revoke_arguments",
"error_message": "Please include a session_id, session_token, session_jwt, or a member_id (if the project is a B2B project). Exactly one of those values is required to revoke a session.",
"error_url": "https://stytch.com/docs/api/errors/400#no_session_revoke_arguments"
}no_signup_redirect_url
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_signup_redirect_url",
"error_message": "There are no signup redirect URLs registered. To set signup redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation.",
"error_url": "https://stytch.com/docs/api/errors/400#no_signup_redirect_url"
}no_signup_redirect_urls_set
400Bad request
Unable to verify the provided signup_magic_link_url. There are no sign-up redirect URLs set for this project so we are unable to verify the signup_magic_link_url provided in the request. To set signup redirect URLs for the project please visit the dashboard here. For more information on why this validation is necessary please read more here.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_signup_redirect_urls_set",
"error_message": "Unable to verify the provided signup_magic_link_url. There are no signup redirect URLs set for this project so we are unable to verify the signup_magic_link_url provided in the request. To set signup redirect URLs for this project please visit https://stytch.com/dashboard/redirect-urls. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#no_signup_redirect_urls_set"
}no_user_password
400Bad request
An existing user doesn't have an password. A password can be added to a user through the password reset endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_user_password",
"error_message": "user doesn't have an associated password.",
"error_url": "https://stytch.com/docs/api/errors/400#no_user_password"
}no_user_selection_arguments
400Bad request
Please include exactly one of user_id, session_token, or session_jwt. This request did not contain any of those fields.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_user_selection_arguments",
"error_message": "Please include exactly one of user_id, session_token, or session_jwt. This request did not contain any of those fields.",
"error_url": "https://stytch.com/docs/api/errors/400#no_user_selection_arguments"
}no_wildcards_in_live_redirect_url
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "no_wildcards_in_live_redirect_url",
"error_message": "",
"error_url": "https://stytch.com/docs/api/errors/400#no_wildcards_in_live_redirect_url"
}oauth_app_not_authorized
400Bad request
You did not authorize this app to perform a signup or login. To use this app, log in again and authorize the required permissions during the login flow. Please reach out to the application developer for more support.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_app_not_authorized",
"error_message": "You did not authorize this app to perform a signup or login. To use this app, log in again and authorize the required permissions during the login flow. Please reach out to the application developer for more support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_app_not_authorized"
}oauth_invalid_callback_request
400Bad request
The OAuth callback request is invalid. Please reach out to the application developer for support.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_invalid_callback_request",
"error_message": "The OAuth callback request is invalid. Please reach out to the application developer for support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_invalid_callback_request"
}oauth_invalid_state
400Bad request
The OAuth state is invalid. Please reach out to the application developer for support.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_invalid_state",
"error_message": "The OAuth state is invalid. Please reach out to the application developer for support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_invalid_state"
}oauth_state_mismatch
400Bad request
The state in the cookie doesn't match with the state in the query parameter. Please reach out to the application developer for support.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_state_mismatch",
"error_message": "The state in the cookie doesn't match with the state in the query parameter. Please reach out to the application developer for support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_state_mismatch"
}password_already_exists
400Bad request
User already has a password associated with it. Please use the password reset endpoint to update the password if needed.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "password_already_exists",
"error_message": "email already has a password associated with it.",
"error_url": "https://stytch.com/docs/api/errors/400#password_already_exists"
}pending_totp_exists
400Bad request
Cannot create a new TOTP for the specified user since the user has a pending TOTP that has not yet expired. Please try creating a new TOTP for the user once the pending one has expired or delete the pending TOTP before attempting to create a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "pending_totp_exists",
"error_message": "Cannot create a new TOTP for the specified user since the user has a pending TOTP that has not yet expired. Please try creating a new TOTP for the user once the pending one has expired or delete the pending TOTP before attempting to create a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#pending_totp_exists"
}pkce_did_not_expect_code_verifier
400Bad request
This flow was started using a code_challenge but the authentication call is missing the corresponding code_verifier.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "pkce_did_not_expect_code_verifier",
"error_message": "This flow was started using a code_challenge but the authentication call is missing the corresponding code_verifier.",
"error_url": "https://stytch.com/docs/api/errors/400#pkce_did_not_expect_code_verifier"
}pkce_expected_code_verifier
400Bad request
This flow was started using a code_challenge but the authentication call is missing the corresponding code_verifier.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "pkce_expected_code_verifier",
"error_message": "This flow was started using a code_challenge but the authentication call is missing the corresponding code_verifier.",
"error_url": "https://stytch.com/docs/api/errors/400#pkce_expected_code_verifier"
}pkce_mismatch
400Bad request
The submitted code_verifier does not match the code_challenge sent at the start of the flow.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "pkce_mismatch",
"error_message": "The submitted code_verifier does not match the code_challenge sent at the start of the flow.",
"error_url": "https://stytch.com/docs/api/errors/400#pkce_mismatch"
}pkce_required_for_native_callback
400Bad request
One of the callback URLs supplied is for a native or mobile application. Stytch requires native or mobile applications to use PKCE for all flows involving redirects. Please supply a code_challenge with the request.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "pkce_required_for_native_callback",
"error_message": "One of the callback URLs supplied is for a native or mobile application. Stytch requires native or mobile applications to use PKCE for all flows involving redirects. Please supply a code_challenge with the request.",
"error_url": "https://stytch.com/docs/api/errors/400#pkce_required_for_native_callback"
}private_key_too_long
400Bad request
Private key is too long. Please make sure you have the correct value.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "private_key_too_long",
"error_message": "Private key is too long. Please make sure you have the correct value.",
"error_url": "https://stytch.com/docs/api/errors/400#private_key_too_long"
}project_has_no_public_tokens
400Bad request
Project has no public_tokens. Please create one in the Dashboard at https://stytch.com/dashboard/api-keys.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "project_has_no_public_tokens",
"error_message": "Project has no public_tokens. Please create one in the Dashboard at https://stytch.com/dashboard/api-keys.",
"error_url": "https://stytch.com/docs/api/errors/400#project_has_no_public_tokens"
}public_key_missing
400Bad request
Public key missing from request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "public_key_missing",
"error_message": "Public key missing from request",
"error_url": "https://stytch.com/docs/api/errors/400#public_key_missing"
}public_token_required
400Bad request
public_token is required.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "public_token_required",
"error_message": "public_token is required.",
"error_url": "https://stytch.com/docs/api/errors/400#public_token_required"
}query_params_do_not_match
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "query_params_do_not_match",
"error_message": "The redirect url in the request provided query parameters that did not match any redirect URLs set on the Stytch dashboard for this project. Please visit https://stytch.com/dashboard/redirect-urls to make any necessary updates. For more information on why this validation is necessary please visit https://stytch.com/docs/api/url-validation",
"error_url": "https://stytch.com/docs/api/errors/400#query_params_do_not_match"
}recovery_code_used_as_totp_code
400Bad request
The totp_code submitted was invalid. Based on the format of the submitted value it looks like a recovery_code was entered instead. To authenticate a recovery code please use the /v1/totps/recover endpoint. You can read more here: https://stytch.com/docs/api/totp-recover.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "recovery_code_used_as_totp_code",
"error_message": "The totp_code submitted was invalid. Based on the format of the submitted value it looks like a recovery_code was entered instead. To authenticate a recovery code please use the /v1/totps/recover endpoint. You can read more here: https://stytch.com/docs/api/totp-recover.",
"error_url": "https://stytch.com/docs/api/errors/400#recovery_code_used_as_totp_code"
}redirect_url_cannot_use_protocol
400Bad request
Redirect URLs are not allowed to use this protocol. Please use a different protocol for your native application. If you believe this to be in error, please contact support@stytch.com for assistance.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "redirect_url_cannot_use_protocol",
"error_message": "Redirect URLs are not allowed to use this protocol. Please use a different protocol for your native application. If you believe this to be in error, please contact support@stytch.com for assistance.",
"error_url": "https://stytch.com/docs/api/errors/400#redirect_url_cannot_use_protocol"
}redirect_url_must_use_https
400Bad request
Redirect URLs for web applications must use HTTPS unless redirecting to localhost. Please change the protocol to HTTPS.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "redirect_url_must_use_https",
"error_message": "Redirect URLs for web applications must use HTTPS unless redirecting to localhost. Please change the protocol to HTTPS.",
"error_url": "https://stytch.com/docs/api/errors/400#redirect_url_must_use_https"
}redirect_url_with_wildcard_cannot_be_default
400Bad request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "redirect_url_with_wildcard_cannot_be_default",
"error_message": "",
"error_url": "https://stytch.com/docs/api/errors/400#redirect_url_with_wildcard_cannot_be_default"
}required_custom_email_domain
400Bad request
a custom email domain is required for custom html emails.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "required_custom_email_domain",
"error_message": "a custom email domain is required for custom html emails.",
"error_url": "https://stytch.com/docs/api/errors/400#required_custom_email_domain"
}reserved_claims_in_custom_claims
400Bad request
Cannot use a reserved claim as one of your custom claims.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "reserved_claims_in_custom_claims",
"error_message": "Cannot use a reserved claim as one of your custom claims.",
"error_url": "https://stytch.com/docs/api/errors/400#reserved_claims_in_custom_claims"
}reset_password
400Bad request
User must reset their password through the password reset endpoint. This occurs if a user's credentials appeared in the HaveIBeenPwned dataset or the user used email based authentication (e.g. Magic Links, Google OAuth) without previously verified their email address. The password reset ensures that the user is the legitimate owner of the mail address. This stops malicious actors from abusing the compromised credentials or attempting to pre-hijack account by setting a password for an email.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "reset_password",
"error_message": "user must reset their password",
"error_url": "https://stytch.com/docs/api/errors/400#reset_password"
}scrypt_key_length_mismatch
400Bad request
The key_length value doesn't match the length of the provided hash.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "scrypt_key_length_mismatch",
"error_message": "The key_length value doesn't match the length of the provided hash.",
"error_url": "https://stytch.com/docs/api/errors/400#scrypt_key_length_mismatch"
}search_invalid_status_filter
400Bad request
status should be set to 'active' or 'pending'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "search_invalid_status_filter",
"error_message": "status should be set to 'active' or 'pending'.",
"error_url": "https://stytch.com/docs/api/errors/400#search_invalid_status_filter"
}search_timeout
400Bad request
Search timed out. Please try using a more specific search query
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "search_timeout",
"error_message": "Search timed out. Please try using a more specific search query",
"error_url": "https://stytch.com/docs/api/errors/400#search_timeout"
}session_must_have_at_least_one_active_factor
400Bad request
The provided session has no active factors and has been revoked.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "session_must_have_at_least_one_active_factor",
"error_message": "The provided session has no active factors and has been revoked.",
"error_url": "https://stytch.com/docs/api/errors/400#session_must_have_at_least_one_active_factor"
}session_on_code_does_not_match_session_passed_in
400Bad request
The session passed in on the /send request does not match the one passed in on this request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "session_on_code_does_not_match_session_passed_in",
"error_message": "The session passed in on the /send request does not match the one passed in on this request",
"error_url": "https://stytch.com/docs/api/errors/400#session_on_code_does_not_match_session_passed_in"
}signature_is_incorrect_size
400Bad request
The signature is the incorrect size in bytes.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "signature_is_incorrect_size",
"error_message": "The signature is the incorrect size in bytes.",
"error_url": "https://stytch.com/docs/api/errors/400#signature_is_incorrect_size"
}signature_missing
400Bad request
Signature missing from request
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "signature_missing",
"error_message": "Signature missing from request",
"error_url": "https://stytch.com/docs/api/errors/400#signature_missing"
}stytch_claims_in_custom_claims
400Bad request
Cannot use https://stytch.com/session as a custom claim.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "stytch_claims_in_custom_claims",
"error_message": "Cannot use https://stytch.com/session as a custom claim.",
"error_url": "https://stytch.com/docs/api/errors/400#stytch_claims_in_custom_claims"
}test_id_used_in_live_environment
400Bad request
Invalid argument sent to Live environment. Looks like you supplied a Test identifier inside a request for the Live environment (api.stytch.com). Try sending the request to test.stytch.com instead or using a different identifier.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "test_id_used_in_live_environment",
"error_message": "Invalid argument sent to Live environment. Looks like you supplied a Test identifier inside a request for the Live environment (api.stytch.com). Try sending the request to test.stytch.com instead or using a different identifier.",
"error_url": "https://stytch.com/docs/api/errors/400#test_id_used_in_live_environment"
}too_many_biometric_registrations_for_user
400Bad request
The provided user_id has reached the maximum allowed mobile biometric registrations. The maximum is 25.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_biometric_registrations_for_user",
"error_message": "The provided user_id has reached the maximum allowed mobile biometric registrations. The maximum is 25.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_biometric_registrations_for_user"
}too_many_m2m_client_scopes
400Bad request
Too many scopes were attached to the client. A maximum of 1000 scopes is allowed.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_m2m_client_scopes",
"error_message": "Too many scopes were attached to the client. A maximum of 1000 scopes is allowed.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_m2m_client_scopes"
}too_many_session_arguments
400Bad request
Please include at most one of session_token, session_jwt, or intermediate_session_token in an authenticate request, not multiple.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_session_arguments",
"error_message": "Please include at most one of session_token, session_jwt, or intermediate_session_token in an authenticate request, not multiple.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_session_arguments"
}too_many_session_revoke_arguments
400Bad request
Please ensure only one of the following is passed: session_id, session_token, session_jwt, or a member_id (if the project is a B2B project). Exactly one of those values is required to revoke a session.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_session_revoke_arguments",
"error_message": "Please ensure only one of the following is passed: session_id, session_token, session_jwt, or a member_id (if the project is a B2B project). Exactly one of those values is required to revoke a session.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_session_revoke_arguments"
}too_many_sms_templates
400Bad request
The current project has already hit the maximum of 5 SMS templates. Please delete one in order to create another.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_sms_templates",
"error_message": "The current project has already hit the maximum of 5 SMS templates. Please delete one in order to create another.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_sms_templates"
}too_many_unverified_factors
400Bad request
We were unable to create a new auth factor. This user already has too many unverified factors.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_unverified_factors",
"error_message": "We were unable to create a new auth factor. This user already has too many unverified factors.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_unverified_factors"
}too_many_user_registrations_for_domain
400Bad request
The provided user_id has reached the maximum allowed WebAuthn registrations for the provided domain. The maximum is 25.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_user_registrations_for_domain",
"error_message": "The provided user_id has reached the maximum allowed WebAuthn registrations for the provided domain. The maximum is 25.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_user_registrations_for_domain"
}too_many_user_selection_arguments
400Bad request
Please include exactly one of user_id, session_token, or session_jwt. This request contained more than one of those fields.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_user_selection_arguments",
"error_message": "Please include exactly one of user_id, session_token, or session_jwt. This request contained more than one of those fields.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_user_selection_arguments"
}totp_code_already_authenticated
400Bad request
This TOTP code has already been authenticated. Please attempt with the next generated code.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "totp_code_already_authenticated",
"error_message": "This TOTP code has already been authenticated. Please attempt with the next generated code.",
"error_url": "https://stytch.com/docs/api/errors/400#totp_code_already_authenticated"
}totp_code_used_as_recovery_code
400Bad request
The recovery_code submitted was invalid. Based on the format of the submitted value it looks like a totp_code was entered instead. To authenticate a totp code please use the /v1/totps/authenticate endpoint. You can read more here: https://stytch.com/docs/api/totp-authenticate.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "totp_code_used_as_recovery_code",
"error_message": "The recovery_code submitted was invalid. Based on the format of the submitted value it looks like a totp_code was entered instead. To authenticate a totp code please use the /v1/totps/authenticate endpoint. You can read more here: https://stytch.com/docs/api/totp-authenticate.",
"error_url": "https://stytch.com/docs/api/errors/400#totp_code_used_as_recovery_code"
}unable_to_authenticate_crypto_wallet
400Bad request
The crypto wallet could not be authenticated.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_authenticate_crypto_wallet",
"error_message": "The crypto wallet could not be authenticated.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_authenticate_crypto_wallet"
}unable_to_authorize_oauth_provider
400Bad request
Unable to authorize request to this OAuth provider. Please check your project's client ID and secret.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_authorize_oauth_provider",
"error_message": "Unable to authorize request to this OAuth provider. Please check your project's client ID and secret.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_authorize_oauth_provider"
}unable_to_delete_last_public_token
400Bad request
Cannot delete the last public_token for a project. Please create another public_token before deleting this one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_delete_last_public_token",
"error_message": "Cannot delete the last public_token for a project. Please create another public_token before deleting this one.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_delete_last_public_token"
}unable_to_parse_session_jwt
400Bad request
Unable to parse session JWT
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_parse_session_jwt",
"error_message": "Unable to parse session JWT",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_parse_session_jwt"
}unable_to_register_biometric_registration
400Bad request
The Biometric registration could not be registered.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_register_biometric_registration",
"error_message": "The Biometric registration could not be registered. ",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_register_biometric_registration"
}unable_to_register_webauthn_registration
400Bad request
The WebAuthn registration could not be registered.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_register_webauthn_registration",
"error_message": "The WebAuthn registration could not be registered.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_register_webauthn_registration"
}unable_to_represent_custom_claims_json
400Bad request
Unable to represent custom claims as a JSON map.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_represent_custom_claims_json",
"error_message": "Unable to represent custom claims as a JSON map.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_represent_custom_claims_json"
}unauthorized_client
400Bad request
Please check that the client_id and client_secret are correct, and that the client exists and is active.
Common causes
The client was not found or the client_id was incorrect.
The secret was incorrect.
The client is not active.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error": "unauthorized_client",
"error_description": "Please check that the `client_id` and `client_secret` are correct, and that the client exists and is active.",
"error_uri": "https://stytch.com/docs/api/errors/400#unauthorized_client"
}unsupported_grant_type
400Bad request
Unsupported grant type. Note that the grant_type parameter must be equal to client_credentials in order for the request to succeed.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error": "unsupported_grant_type",
"error_description": "Unsupported grant type. Note that the `grant_type` parameter must be equal to `client_credentials` in order for the request to succeed.",
"error_uri": "https://stytch.com/docs/api/errors/400#unsupported_grant_type"
}update_user_auth_method_not_allowed
400Bad request
Update user no longer accepts phone_numbers, emails, or crypto_wallets. To add these authentication factors to an existing user, use their respective Send endpoints.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "update_user_auth_method_not_allowed",
"error_message": "Update user no longer accepts phone_numbers, emails, or crypto_wallets. To add these authentication factors to an existing user, use their respective Send endpoints.",
"error_url": "https://stytch.com/docs/api/errors/400#update_user_auth_method_not_allowed"
}user_already_invited
400Bad request
The user has already been invited.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_already_invited",
"error_message": "The user has already been invited.",
"error_url": "https://stytch.com/docs/api/errors/400#user_already_invited"
}user_search_email_address_fuzzy_too_short
400Bad request
Expected email_address_fuzzy to have a length of at least 3 but it was too short. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_email_address_fuzzy_too_short",
"error_message": "Expected email_address_fuzzy to have a length of at least 3 but it was too short. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_email_address_fuzzy_too_short"
}user_search_expected_array_of_string
400Bad request
Expected user search filter_value to contain an array of strings. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_expected_array_of_string",
"error_message": "Expected user search filter_value to contain an array of strings. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_expected_array_of_string"
}user_search_expected_bool
400Bad request
Expected user search filter_value to contain a boolean. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_expected_bool",
"error_message": "Expected user search filter_value to contain a boolean. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_expected_bool"
}user_search_expected_object
400Bad request
Expected user search filter_value to contain an object. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_expected_object",
"error_message": "Expected user search filter_value to contain an object. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_expected_object"
}user_search_expected_string
400Bad request
Expected user search filter_value to contain a string. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_expected_string",
"error_message": "Expected user search filter_value to contain a string. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_expected_string"
}user_search_expected_timestamp
400Bad request
Expected user search filter_value to contain a string containing a RFC3339 formatted timestamp. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_expected_timestamp",
"error_message": "Expected user search filter_value to contain a string containing a RFC3339 formatted timestamp. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_expected_timestamp"
}user_search_filter_name_must_be_string
400Bad request
Expected user search operand filter_name to be a string. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_filter_name_must_be_string",
"error_message": "Expected user search operand filter_name to be a string. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_filter_name_must_be_string"
}user_search_filter_name_not_recognized
400Bad request
The user search operand filter_name was not recognized. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_filter_name_not_recognized",
"error_message": "The user search operand filter_name was not recognized. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_filter_name_not_recognized"
}user_search_full_name_fuzzy_too_short
400Bad request
Expected full_name_fuzzy to have a length of at least 3 but it was too short. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_full_name_fuzzy_too_short",
"error_message": "Expected full_name_fuzzy to have a length of at least 3 but it was too short. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_full_name_fuzzy_too_short"
}user_search_invalid_cursor
400Bad request
The submitted cursor is not valid. Please contact support@stytch.com for assistance.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_invalid_cursor",
"error_message": "The submitted cursor is not valid. Please contact support@stytch.com for assistance.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_invalid_cursor"
}user_search_invalid_limit
400Bad request
limit should be in the range 1 to 1000 inclusive.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_invalid_limit",
"error_message": "limit should be in the range 1 to 1000 inclusive.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_invalid_limit"
}user_search_invalid_oauth_provider_filter
400Bad request
provider should be set to 'Apple', 'GitHub', 'Google', 'Facebook', or 'Microsoft'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_invalid_oauth_provider_filter",
"error_message": "provider should be set to 'Apple', 'GitHub', 'Google', 'Facebook', or 'Microsoft'.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_invalid_oauth_provider_filter"
}user_search_invalid_operator
400Bad request
operator should be set to 'AND' or 'OR'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_invalid_operator",
"error_message": "operator should be set to 'AND' or 'OR'.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_invalid_operator"
}user_search_invalid_status_filter
400Bad request
status should be set to 'active' or 'pending'.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_invalid_status_filter",
"error_message": "status should be set to 'active' or 'pending'.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_invalid_status_filter"
}user_search_missing_biometric_registration_ids
400Bad request
Expected biometric_registration_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_biometric_registration_ids",
"error_message": "Expected biometric_registration_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_biometric_registration_ids"
}user_search_missing_biometric_verified
400Bad request
Expected field biometric_registration_ids to be passed in the search request but it was not. Please see search users endpoint for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_biometric_verified",
"error_message": "Expected biometric_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_biometric_verified"
}user_search_missing_created_at_greater_than
400Bad request
Expected created_at_greater_than to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_created_at_greater_than",
"error_message": "Expected created_at_greater_than to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_created_at_greater_than"
}user_search_missing_created_at_less_than
400Bad request
Expected created_at_less_than to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_created_at_less_than",
"error_message": "Expected created_at_less_than to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_created_at_less_than"
}user_search_missing_email_address_fuzzy
400Bad request
Expected email_address_fuzzy to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_email_address_fuzzy",
"error_message": "Expected email_address_fuzzy to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_email_address_fuzzy"
}user_search_missing_email_addresses
400Bad request
Expected email_addresses to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_email_addresses",
"error_message": "Expected email_addresses to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_email_addresses"
}user_search_missing_email_ids
400Bad request
Expected email_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_email_ids",
"error_message": "Expected email_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_email_ids"
}user_search_missing_email_verified
400Bad request
Expected email_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_email_verified",
"error_message": "Expected email_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_email_verified"
}user_search_missing_filter_name
400Bad request
Expected user search operand to contain a filter_name key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_filter_name",
"error_message": "Expected user search operand to contain a filter_name key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_filter_name"
}user_search_missing_filter_value
400Bad request
Expected user search operand to contain a filter_value key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_filter_value",
"error_message": "Expected user search operand to contain a filter_value key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_filter_value"
}user_search_missing_full_name_fuzzy
400Bad request
Expected full_name_fuzzy to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_full_name_fuzzy",
"error_message": "Expected full_name_fuzzy to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_full_name_fuzzy"
}user_search_missing_greater_than
400Bad request
Expected user search filter_value to contain greater_than key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_greater_than",
"error_message": "Expected user search filter_value to contain greater_than key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_greater_than"
}user_search_missing_less_than
400Bad request
Expected user search filter_value to contain less_than key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_less_than",
"error_message": "Expected user search filter_value to contain less_than key. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_less_than"
}user_search_missing_oauth_providers
400Bad request
Expected oauth_providers to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_oauth_providers",
"error_message": "Expected oauth_providers to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_oauth_providers"
}user_search_missing_password
400Bad request
Expected field password_exist to be passed in the search request but it was not. Please see search users endpoint for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_password",
"error_message": "Expected password to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_password"
}user_search_missing_phone_ids
400Bad request
Expected phone_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_phone_ids",
"error_message": "Expected phone_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_phone_ids"
}user_search_missing_phone_number_fuzzy
400Bad request
Expected phone_number_fuzzy to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_phone_number_fuzzy",
"error_message": "Expected phone_number_fuzzy to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_phone_number_fuzzy"
}user_search_missing_phone_numbers
400Bad request
Expected phone_numbers to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_phone_numbers",
"error_message": "Expected phone_numbers to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_phone_numbers"
}user_search_missing_phone_verified
400Bad request
Expected phone_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_phone_verified",
"error_message": "Expected phone_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_phone_verified"
}user_search_missing_status
400Bad request
Expected status to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_status",
"error_message": "Expected status to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_status"
}user_search_missing_totp_ids
400Bad request
Expected totp_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_totp_ids",
"error_message": "Expected totp_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_totp_ids"
}user_search_missing_totp_verified
400Bad request
Expected totp_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_totp_verified",
"error_message": "Expected totp_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_totp_verified"
}user_search_missing_user_ids
400Bad request
Expected user_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_user_ids",
"error_message": "Expected user_ids to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_user_ids"
}user_search_missing_webauthn_verified
400Bad request
Expected webauthn_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_missing_webauthn_verified",
"error_message": "Expected webauthn_verified to be passed in the search request but it was not. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_missing_webauthn_verified"
}user_search_phone_number_fuzzy_too_short
400Bad request
Expected phone_number_fuzzy to have a length of at least 3 but it was too short. Please see https://stytch.com/docs/api/search-users for request schema details and examples.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_phone_number_fuzzy_too_short",
"error_message": "Expected phone_number_fuzzy to have a length of at least 3 but it was too short. Please see https://stytch.com/docs/api/search-users for request schema details and examples.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_phone_number_fuzzy_too_short"
}weak_password
400Bad request
Password doesn't meet the API's strength requirements. A password's strength could be tested with the password strength check endpoint.
Common causes
Troubleshooting steps
Use the password strength check endpoint endpoint to get actionable feedback on improving the strength of the password string. This feedback can be passed on to the end user via your UI.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "weak_password",
"error_message": "password doesn't meet our strength requirements.",
"error_url": "https://stytch.com/docs/api/errors/400#weak_password"
}