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
400
Bad requestError
{
"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"
}allow_list_max_exceeded
400
Bad requestThe number of user methods registered to the allow list has exceeded the maximum of 500.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "allow_list_max_exceeded",
"error_message": "The number of user methods registered to the allow list has exceeded the maximum of 500.",
"error_url": "https://stytch.com/docs/api/errors/400#allow_list_max_exceeded"
}apple_oauth_config_not_found
400
Bad requestThe 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
400
Bad requestThe 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_app_bundle_for_stytch_sdk
400
Bad requestThis app bundle ID has not been registered as an allowed app for the Stytch SDK. Please add it here: https://stytch.com/dashboard/sdk-configuration
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "bad_app_bundle_for_stytch_sdk",
"error_message": "This app bundle ID has not been registered as an allowed app for the Stytch SDK. Please add it here: https://stytch.com/dashboard/sdk-configuration",
"error_url": "https://stytch.com/docs/api/errors/400#bad_app_bundle_for_stytch_sdk"
}bad_domain_for_stytch_sdk
400
Bad requestThis website has not been registered as an allowed domain for the Stytch SDK. Please add it here: https://stytch.com/dashboard/sdk-configuration
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "bad_domain_for_stytch_sdk",
"error_message": "This website has not been registered as an allowed domain for the Stytch SDK. Please add it here: https://stytch.com/dashboard/sdk-configuration",
"error_url": "https://stytch.com/docs/api/errors/400#bad_domain_for_stytch_sdk"
}bad_request
400
Bad requestThe 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"
}bad_vertical_for_stytch_sdk
400
Bad requestThe credentials used match a different vertical than the one specified in the SDK configuration. Please check if you are using a B2B or B2C project.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "bad_vertical_for_stytch_sdk",
"error_message": "The credentials used match a different vertical than the one specified in the SDK configuration. Please check if you are using a B2B or B2C project.",
"error_url": "https://stytch.com/docs/api/errors/400#bad_vertical_for_stytch_sdk"
}billing_not_verified
400
Bad requestYou 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. 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
400
Bad requestYou 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. 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
400
Bad requestPassword 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
400
Bad requestThe 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
400
Bad requestCannot 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
400
Bad requestYou 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_remove_primary_auth_mechanism
400
Bad requestIf you remove this factor, the user will be unable to log in.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "cannot_remove_primary_auth_mechanism",
"error_message": "If you remove this factor, the user will be unable to log in.",
"error_url": "https://stytch.com/docs/api/errors/400#cannot_remove_primary_auth_mechanism"
}cannot_reset_password_with_existing_password
400
Bad requestCannot 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
400
Bad requestMobile 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
400
Bad requestError
{
"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-register-start 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
400
Bad requestClient 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
400
Bad requestCould 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"
}crypto_wallet_type_incompatible_with_siwe
400
Bad requestYou may only pass in siwe_params if the wallet type is Ethereum.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "crypto_wallet_type_incompatible_with_siwe",
"error_message": "You may only pass in siwe_params if the wallet type is Ethereum.",
"error_url": "https://stytch.com/docs/api/errors/400#crypto_wallet_type_incompatible_with_siwe"
}custom_claims_too_large
400
Bad requestCustom 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"
}deny_list_max_exceeded
400
Bad requestThe number of user methods registered to the deny list has exceeded the maximum of 500.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "deny_list_max_exceeded",
"error_message": "The number of user methods registered to the deny list has exceeded the maximum of 500.",
"error_url": "https://stytch.com/docs/api/errors/400#deny_list_max_exceeded"
}deprecated_endpoint
400
Bad requestThis 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
400
Bad requestThis 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_custom_hostname_found
400
Bad requestDuplicate custom hostname found during CNAME creation. A custom hostname can only be used in one project.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "duplicate_custom_hostname_found",
"error_message": "Duplicate custom hostname found during CNAME creation. A custom hostname can only be used in one project.",
"error_url": "https://stytch.com/docs/api/errors/400#duplicate_custom_hostname_found"
}duplicate_email
400
Bad requestA 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestAn 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
400
Bad requestA 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestA 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
400
Bad requestA 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
400
Bad requestA 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestInvalid 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
400
Bad requestThe 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"
}forbidden_character_zero_width_space
400
Bad requestZero width space (U+200B) identified in request, please remove.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "forbidden_character_zero_width_space",
"error_message": "Zero width space (U+200B) identified in request, please remove.",
"error_url": "https://stytch.com/docs/api/errors/400#forbidden_character_zero_width_space"
}id_token_expired
400
Bad requestID 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
400
Bad requestID 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
400
Bad requestID 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
400
Bad requestThe 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
400
Bad requestThe email provided has been marked as inactive by our email provider.
Common causes
Our email provider received a hard bounce when previously attempting to deliver an email to this email address.
This user previously marked an email sent by Stytch as spam.
Troubleshooting steps
Confirm with your user that their email address can now successfully receive emails.
If our email provider previously hit a hard bounce but the email address can now successfully receive emails, you can reactivate it via the User management or Members tab in the Stytch Dashboard.
If the user previously marked a Stytch email as spam but is now interested in receiving Stytch emails again, please reach out to support@stytch.com so that we can reactivate their email address.
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. If the cause of the hard bounce has been resolved, you can reactivate the email address via the User management tab or the Members tab in the Stytch Dashboard.",
"error_url": "https://stytch.com/docs/api/errors/400#inactive_email"
}incompatible_session_type
400
Bad requestSession 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestInvalid 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
400
Bad requestThe 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
400
Bad requestInvalid 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestbiometric_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
400
Bad requestThe 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
400
Bad requestcaptcha_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
400
Bad requestprovider_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
400
Bad requestthreshold 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
400
Bad requestCode 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
400
Bad requestInvalid 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_address
400
Bad requestcrypto_wallet_address must be nonempty.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_crypto_wallet_address",
"error_message": "crypto_wallet_address must be nonempty.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_crypto_wallet_address"
}invalid_crypto_wallet_id
400
Bad requestThe 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
400
Bad requestThanks 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
400
Bad requestInvalid 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
400
Bad requestThe 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_domain
400
Bad requestEmail domain is too large. Please contact support if this is a valid email.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_email_domain",
"error_message": "Email domain is too large. Please contact support if this is a valid email.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_email_domain"
}invalid_email_html
400
Bad requestemail 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
400
Bad requestThe 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
400
Bad requestemail 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
400
Bad requestInvalid 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
400
Bad requestemail 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
400
Bad requestcrypto_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
400
Bad requestPlease 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
400
Bad requestThe 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
400
Bad requestExpiration 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
400
Bad requestexpiration_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
400
Bad requesthash 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
400
Bad requestThe 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
400
Bad requestID 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
400
Bad requestinvite_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
400
Bad requestinvite_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
400
Bad requestip_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
400
Bad requestlocale 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
400
Bad requestlogin_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
400
Bad requestlogin_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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestmagic_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
400
Bad requestThe 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
400
Bad requestThe 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_mobile_identifier
400
Bad requestThe mobile header sent is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_mobile_identifier",
"error_message": "The mobile header sent is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_mobile_identifier"
}invalid_oauth_attach_token
400
Bad requestThe 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
400
Bad requestWe 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
400
Bad requestoauth_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
400
Bad requestorganization_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
400
Bad requestOrganization 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
400
Bad requestpassword_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
400
Bad requestreset_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_password_strength_luds_complexity
400
Bad requestThe LUDS password complexity should be between 1 and 4, inclusive.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_password_strength_luds_complexity",
"error_message": "The LUDS password complexity should be between 1 and 4, inclusive.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_password_strength_luds_complexity"
}invalid_password_strength_luds_length
400
Bad requestThe minimum password length should be between 8 and 32, inclusive.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_password_strength_luds_length",
"error_message": "The minimum password length should be between 8 and 32, inclusive.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_password_strength_luds_length"
}invalid_pbkdf_2_hash
400
Bad requestThe 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
400
Bad requestThe provided PBKDF-2 iteration_amount value is invalid. Valid range: 512-650000.
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-650000.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pbkdf_2_iteration_amount"
}invalid_pbkdf_2_salt
400
Bad requestThe provided PBKDF-2 salt is invalid.
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 invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_pbkdf_2_salt"
}invalid_phone_number
400
Bad requestThe 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] 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
400
Bad requestThe 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
400
Bad requestThanks 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
400
Bad requestPhone 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestproject_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
400
Bad requestThe 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_project_name
400
Bad requestThe project name is invalid.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_project_name",
"error_message": "The project name is invalid.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_project_name"
}invalid_public_key
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestInvalid 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
400
Bad requestInvalid 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
400
Bad requestrequest_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
400
Bad requestInvalid 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
400
Bad requestRole 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
400
Bad requestPlease 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
400
Bad requestscopes 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
400
Bad requestThe 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
400
Bad requestThe scrypt parameters are too large. The r parameter multiplied 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 multiplied 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestsecret_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
400
Bad requestsession_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
400
Bad requestsession_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
400
Bad requestsession_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
400
Bad requestCannot 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestsignature 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
400
Bad requestsignup_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
400
Bad requestsignup_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_siwe_chain_id
400
Bad requestchain_id must be the string representation of an integer between 1 and 9,223,372,036,854,775,771, inclusive.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_siwe_chain_id",
"error_message": "chain_id must be the string representation of an integer between 1 and 9,223,372,036,854,775,771, inclusive.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_siwe_chain_id"
}invalid_siwe_domain
400
Bad requestDomain must be a valid RFC 3986 authority. Do not include the scheme in the domain.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_siwe_domain",
"error_message": "Domain must be a valid RFC 3986 authority. Do not include the scheme in the domain.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_siwe_domain"
}invalid_siwe_message_request_id
400
Bad requestmessage_request_id must be a valid pchar according to RFC 3986 definitions and must not exceed 100 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_siwe_message_request_id",
"error_message": "message_request_id must be a valid pchar according to RFC 3986 definitions and must not exceed 100 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_siwe_message_request_id"
}invalid_siwe_resource
400
Bad requestResources must be a list of valid RFC 3986 URIs.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_siwe_resource",
"error_message": "Resources must be a list of valid RFC 3986 URIs.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_siwe_resource"
}invalid_siwe_statement
400
Bad requestStatement may only include reserved, unreserved, or space characters according to RFC 3986 definitions. The statement must not contain other forms of whitespace such as newlines, tabs, and carriage returns. The statement must not exceed 200 characters.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_siwe_statement",
"error_message": "Statement may only include reserved, unreserved, or space characters according to RFC 3986 definitions. The statement must not contain other forms of whitespace such as newlines, tabs, and carriage returns. The statement must not exceed 200 characters.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_siwe_statement"
}invalid_siwe_uri
400
Bad requestURI must be a valid RFC 3986 URI.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "invalid_siwe_uri",
"error_message": "URI must be a valid RFC 3986 URI.",
"error_url": "https://stytch.com/docs/api/errors/400#invalid_siwe_uri"
}invalid_solana_address
400
Bad requestcrypto_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
400
Bad requestThe 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
400
Bad requesttemplate_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
400
Bad requesttemplate_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
400
Bad requestToken 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
400
Bad requestThanks 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
400
Bad requestThe 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
400
Bad requesttotp_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
400
Bad requestURL 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
400
Bad requestuser_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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestcrypto_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
400
Bad requestThe 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
400
Bad requestwebauthn_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
400
Bad requestJWT 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
400
Bad requestJWT 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
400
Bad requestJWT 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
400
Bad requestJWT 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
400
Bad requestInvalid 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
400
Bad requestThe 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
400
Bad requestM2M 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
400
Bad requestM2M 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
400
Bad requestM2M 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
400
Bad requestM2M 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
400
Bad requestM2M 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestThe 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
400
Bad requestExpected 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
400
Bad requestExpected 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"
}migrate_from_external_email_does_not_exist
400
Bad requestPlease ensure that the user and email exist before migrating an external session.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "migrate_from_external_email_does_not_exist",
"error_message": "Please ensure that the user and email exist before migrating an external session.",
"error_url": "https://stytch.com/docs/api/errors/400#migrate_from_external_email_does_not_exist"
}migrate_from_external_missing_userinfo
400
Bad requestThe project is missing the OIDC userinfo endpoint. Please configure one in the Stytch dashboard and try again.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "migrate_from_external_missing_userinfo",
"error_message": "The project is missing the OIDC userinfo endpoint. Please configure one in the Stytch dashboard and try again.",
"error_url": "https://stytch.com/docs/api/errors/400#migrate_from_external_missing_userinfo"
}migrate_from_external_unexpected_response
400
Bad requestAn error was encountered when querying the external provider's userinfo endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "migrate_from_external_unexpected_response",
"error_message": "An error was encountered when querying the external provider's userinfo endpoint.",
"error_url": "https://stytch.com/docs/api/errors/400#migrate_from_external_unexpected_response"
}missing_apple_app_id
400
Bad requestThe 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
400
Bad requestOne 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
400
Bad requestNo 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
400
Bad requestNo 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
400
Bad requestA 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
400
Bad requestThere 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
400
Bad requestThere 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
400
Bad requestThere 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
400
Bad requestThere 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
400
Bad requestError
{
"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
400
Bad requestUnable 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
400
Bad requestError
{
"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
400
Bad requestUnable 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestError
{
"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
400
Bad requestUnable 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
400
Bad requestPlease 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
400
Bad requestPlease 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
400
Bad requestError
{
"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
400
Bad requestUnable 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
400
Bad requestAn 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
400
Bad requestPlease 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
400
Bad requestError
{
"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
400
Bad requestYou 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_flow_callback_error
400
Bad requestAn error occurred during the OAuth callback.
Common causes
The OAuth flow couldn't be completed successfully. See the error_details.replay_error_details object for additional information regarding the cause of the error.
If error_details.replay_error_details.error is access_denied, the user likely cancelled the OAuth flow partway through.
Troubleshooting steps
Prompt the user to try completing the OAuth flow again from the beginning.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_flow_callback_error",
"error_message": "An error was encountered in the callback of the OAuth flow. Please try again.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_flow_callback_error"
}oauth_invalid_callback_request
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe state in the cookie doesn't match with the state in the query parameter. Please retry your login flow. If you continue receiving this error, 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 retry your login flow. If you continue receiving this error, reach out to the application developer for support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_state_mismatch"
}oauth_state_used
400
Bad requestThe OAuth state value has already been used.
Common causes
The user completed the same OAuth flow twice. For example, they completed the OAuth flow, then navigated back in the browser and completed it again.
Troubleshooting steps
If the user already has an active Stytch Session, this error can likely be ignored.
If the user does not have an active Stytch Session, prompt them to try completing the OAuth flow again from the beginning.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_state_used",
"error_message": "The OAuth state has previously been used. Please try the login flow again.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_state_used"
}oauth_token_exchange_invalid_client
400
Bad requestClient authentication failed (e.g., unknown client, no client authentication included, or unsupported authentication method). Please check the client ID and secret of your OAuth configuration.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_exchange_invalid_client",
"error_message": "Client authentication failed (e.g., unknown client, no client authentication included, or unsupported authentication method). Please check the client ID and secret of your OAuth configuration.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_token_exchange_invalid_client"
}oauth_token_exchange_invalid_request
400
Bad requestThe request is missing a required parameter, includes an unsupported parameter value (other than grant type), repeats a parameter, includes multiple credentials, utilizes more than one mechanism for authenticating the client, or is otherwise malformed. Please reach out to support.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_exchange_invalid_request",
"error_message": "The request is missing a required parameter, includes an unsupported parameter value (other than grant type), repeats a parameter, includes multiple credentials, utilizes more than one mechanism for authenticating the client, or is otherwise malformed. Please reach out to support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_token_exchange_invalid_request"
}oauth_token_exchange_invalid_scope
400
Bad requestThe scopes requested were invalid. Please check the scopes you are requesting and try again.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_exchange_invalid_scope",
"error_message": "The scopes requested were invalid. Please check the scopes you are requesting and try again.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_token_exchange_invalid_scope"
}oauth_token_exchange_microsoft_expired_secret
400
Bad requestExpired client secret provided. Ensure the secret in your OAuth configuration is up to date. You may need to add a new secret in your Microsoft Azure portal.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_exchange_microsoft_expired_secret",
"error_message": "Expired client secret provided. Ensure the secret in your OAuth configuration is up to date. You may need to add a new secret in your Microsoft Azure portal.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_token_exchange_microsoft_expired_secret"
}oauth_token_exchange_microsoft_invalid_secret
400
Bad requestInvalid client secret provided. Ensure the secret in your OAuth configuration is the client secret value, not the client secret ID.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_exchange_microsoft_invalid_secret",
"error_message": "Invalid client secret provided. Ensure the secret in your OAuth configuration is the client secret value, not the client secret ID.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_token_exchange_microsoft_invalid_secret"
}oauth_token_exchange_unauthorized_client
400
Bad requestThe authenticated client is not authorized to use this authorization grant type. Please check your settings and try again. If the problem persists, please reach out to support.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oauth_token_exchange_unauthorized_client",
"error_message": "The authenticated client is not authorized to use this authorization grant type. Please check your settings and try again. If the problem persists, please reach out to support.",
"error_url": "https://stytch.com/docs/api/errors/400#oauth_token_exchange_unauthorized_client"
}oidc_response_email_missing
400
Bad requestThe information provided in the ID token and userinfo did not include a email.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "oidc_response_email_missing",
"error_message": "The information provided in the ID token and userinfo did not include a email.",
"error_url": "https://stytch.com/docs/api/errors/400#oidc_response_email_missing"
}password_already_exists
400
Bad requestUser 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"
}password_validation_timeout
400
Bad requestPassword validation timed out. Possible causes include an excessively long password or a high volume of requests.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "password_validation_timeout",
"error_message": "Password validation timed out. Possible causes include an excessively long password or a high volume of requests.",
"error_url": "https://stytch.com/docs/api/errors/400#password_validation_timeout"
}passwords_incompatible_with_sdk_config
400
Bad requestThe passwords product is incompatible with the project SDK configuration. Please change the configuration in the dashboard to continue: https://stytch.com/dashboard/sdk-configuration.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "passwords_incompatible_with_sdk_config",
"error_message": "The passwords product is incompatible with the project SDK configuration. Please change the configuration in the dashboard to continue: https://stytch.com/dashboard/sdk-configuration.",
"error_url": "https://stytch.com/docs/api/errors/400#passwords_incompatible_with_sdk_config"
}pbkdf_2_key_length_mismatch
400
Bad requestThe provided PBKDF-2 key_length does not match the length of the decoded hash.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "pbkdf_2_key_length_mismatch",
"error_message": "The provided PBKDF-2 key_length does not match the length of the decoded hash.",
"error_url": "https://stytch.com/docs/api/errors/400#pbkdf_2_key_length_mismatch"
}pending_totp_exists
400
Bad requestCannot 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
400
Bad requestThis flow was started without a code_challenge but the authentication call includes a 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 without a code_challenge but the authentication call includes a code_verifier.",
"error_url": "https://stytch.com/docs/api/errors/400#pkce_did_not_expect_code_verifier"
}pkce_expected_code_verifier
400
Bad requestThis 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
400
Bad requestThe 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
400
Bad requestOne 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
400
Bad requestPrivate 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
400
Bad requestProject 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
400
Bad requestPublic 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
400
Bad requestpublic_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
400
Bad requestError
{
"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
400
Bad requestThe 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
400
Bad requestRedirect 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
400
Bad requestRedirect 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_query_param_placeholder_cannot_be_default
400
Bad requestRedirect URLs with query param placeholders ({}) cannot be set as a default redirect URL.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "redirect_url_with_query_param_placeholder_cannot_be_default",
"error_message": "Redirect URLs with query param placeholders ({}) cannot be set as a default redirect URL.",
"error_url": "https://stytch.com/docs/api/errors/400#redirect_url_with_query_param_placeholder_cannot_be_default"
}redirect_url_with_wildcard_cannot_be_default
400
Bad requestError
{
"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
400
Bad requesta 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
400
Bad requestCannot 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
400
Bad requestUser 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"
}retired_email_missing_email_identifiers
400
Bad requestYou must provide one of email_id or email_address in the request.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "retired_email_missing_email_identifiers",
"error_message": "You must provide one of email_id or email_address in the request.",
"error_url": "https://stytch.com/docs/api/errors/400#retired_email_missing_email_identifiers"
}scim_connection_not_rotating_token
400
Bad requestBearer token rotation has not been started for this connection. Please start a token rotation flow before calling this endpoint.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "scim_connection_not_rotating_token",
"error_message": "Bearer token rotation has not been started for this connection. Please start a token rotation flow before calling this endpoint.",
"error_url": "https://stytch.com/docs/api/errors/400#scim_connection_not_rotating_token"
}scrypt_key_length_mismatch
400
Bad requestThe 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
400
Bad requeststatus should be set to 'active', 'pending', 'invited', or 'deleted'.
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', 'pending', 'invited', or 'deleted'.",
"error_url": "https://stytch.com/docs/api/errors/400#search_invalid_status_filter"
}search_timeout
400
Bad requestSearch 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_enforced_factor_matching_session_required
400
Bad requestThis action requires either a session_token or session_jwt of the user this authentication factor was attached to.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "session_enforced_factor_matching_session_required",
"error_message": "This action requires either a session_token or session_jwt of the user this authentication factor was attached to.",
"error_url": "https://stytch.com/docs/api/errors/400#session_enforced_factor_matching_session_required"
}session_must_have_at_least_one_active_factor
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestSignature 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"
}siwe_message_expired
400
Bad requestThe SIWE message is expired.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "siwe_message_expired",
"error_message": "The SIWE message is expired.",
"error_url": "https://stytch.com/docs/api/errors/400#siwe_message_expired"
}siwe_message_not_valid_yet
400
Bad requestThe SIWE message is not valid yet.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "siwe_message_not_valid_yet",
"error_message": "The SIWE message is not valid yet.",
"error_url": "https://stytch.com/docs/api/errors/400#siwe_message_not_valid_yet"
}stytch_claims_in_custom_claims
400
Bad requestCannot 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
400
Bad requestInvalid 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
400
Bad requestThe 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_email_templates
400
Bad requestYou have reached the maximum number of email templates for this project. Please delete an email template before creating a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_email_templates",
"error_message": "You have reached the maximum number of email templates for this project. Please delete an email template before creating a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_email_templates"
}too_many_m2m_client_scopes
400
Bad requestToo 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_projects
400
Bad requestYou have reached the maximum number of projects for your workspace. Please delete a project before creating a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_projects",
"error_message": "You have reached the maximum number of projects for your workspace. Please delete a project before creating a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_projects"
}too_many_public_tokens
400
Bad requestYou have reached the maximum number of public tokens for this project. Please delete a public token before creating a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_public_tokens",
"error_message": "You have reached the maximum number of public tokens for this project. Please delete a public token before creating a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_public_tokens"
}too_many_redirect_urls
400
Bad requestYou have reached the maximum number of redirect URLs for this project. Please delete a redirect URL before creating a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_redirect_urls",
"error_message": "You have reached the maximum number of redirect URLs for this project. Please delete a redirect URL before creating a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_redirect_urls"
}too_many_secrets
400
Bad requestYou have reached the maximum number of secrets for this project. Please delete a secret before creating a new one.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_secrets",
"error_message": "You have reached the maximum number of secrets for this project. Please delete a secret before creating a new one.",
"error_url": "https://stytch.com/docs/api/errors/400#too_many_secrets"
}too_many_session_arguments
400
Bad requestPlease 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
400
Bad requestPlease 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
400
Bad requestThe 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
400
Bad requestWe 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
400
Bad requestThe 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
400
Bad requestPlease 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
400
Bad requestThis 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestUnable to authorize request to this OAuth provider. Please check the client ID and secret of your OAuth configuration.
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 the client ID and secret of your OAuth configuration.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_authorize_oauth_provider"
}unable_to_delete_last_public_token
400
Bad requestCannot 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_delete_postmark_suppression
400
Bad requestThe Postmark server returned a non-positive response while trying to delete this suppression.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unable_to_delete_postmark_suppression",
"error_message": "The Postmark server returned a non-positive response while trying to delete this suppression.",
"error_url": "https://stytch.com/docs/api/errors/400#unable_to_delete_postmark_suppression"
}unable_to_parse_session_jwt
400
Bad requestUnable 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
400
Bad requestThe 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
400
Bad requestThe 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
400
Bad requestUnable 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
400
Bad requestPlease 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"
}unsubscribed_phone_number
400
Bad requestUser has unsubscribed. User must resubscribe by texting 'START' before messages can be sent.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unsubscribed_phone_number",
"error_message": "User has unsubscribed. User must resubscribe by texting 'START' before messages can be sent.",
"error_url": "https://stytch.com/docs/api/errors/400#unsubscribed_phone_number"
}unsupported_grant_type
400
Bad requestUnsupported 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
400
Bad requestUpdate 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
400
Bad requestThe 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestThe 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
400
Bad requestExpected 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
400
Bad requestThe 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
400
Bad requestlimit 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
400
Bad requestprovider 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
400
Bad requestoperator 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
400
Bad requeststatus 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_maximum_filter_value_count_exceeded
400
Bad requestThe number of filter values passed in the search request exceeded our maximum of 1000. Please try again with a lower number.
Error
{
"status_code": 400,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "user_search_maximum_filter_value_count_exceeded",
"error_message": "The number of filter values passed in the search request exceeded our maximum of 1000. Please try again with a lower number.",
"error_url": "https://stytch.com/docs/api/errors/400#user_search_maximum_filter_value_count_exceeded"
}user_search_missing_biometric_registration_ids
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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_crypto_wallet_address
400
Bad requestExpected crypto_wallet_address 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_crypto_wallet_address",
"error_message": "Expected crypto_wallet_address 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_crypto_wallet_address"
}user_search_missing_crypto_wallet_id
400
Bad requestExpected crypto_wallet_id 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_crypto_wallet_id",
"error_message": "Expected crypto_wallet_id 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_crypto_wallet_id"
}user_search_missing_crypto_wallet_verified
400
Bad requestExpected crypto_wallet_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_crypto_wallet_verified",
"error_message": "Expected crypto_wallet_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_crypto_wallet_verified"
}user_search_missing_email_address_fuzzy
400
Bad requestExpected 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
400
Bad requestExpected 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_domain
400
Bad requestExpected email_domain 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_domain",
"error_message": "Expected email_domain 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_domain"
}user_search_missing_email_ids
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestExpected 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_registration_ids
400
Bad requestExpected webauthn_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_webauthn_registration_ids",
"error_message": "Expected webauthn_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_webauthn_registration_ids"
}user_search_missing_webauthn_verified
400
Bad requestExpected 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
400
Bad requestExpected 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
400
Bad requestPassword 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"
}