400 errors

active_totp_exists

400Bad request

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

{
  "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/b2b/api/errors/400#active_totp_exists"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

allowed_auth_methods_required_for_restricted

400Bad request

Allowed auth methods must be set for 'RESTRICTED' auth methods

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "allowed_auth_methods_required_for_restricted",
  "error_message": "Allowed auth methods must be set for 'RESTRICTED' auth methods",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#allowed_auth_methods_required_for_restricted"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

apple_oauth_config_not_found

400Bad request

The Apple OAuth config was not found.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "apple_oauth_config_not_found",
  "error_message": "The Apple OAuth config was not found.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#apple_oauth_config_not_found"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

argon_2_key_length_mismatch

400Bad request

The key_length value doesn't match the length of the provided hash.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "argon_2_key_length_mismatch",
  "error_message": "The key_length value doesn't match the length of the provided hash.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#argon_2_key_length_mismatch"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

bad_request

400Bad request

The submitted request is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "bad_request",
  "error_message": "The submitted request is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#bad_request"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

billing_not_verified

400Bad request

You cannot use this endpoint in the live environment until credit card details are added to your account, but you can try the endpoint in the test environment. Once your billing information is verified, this endpoint can be used in live. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please go to billing settings to provide billing information.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "billing_not_verified",
  "error_message": "You cannot use this endpoint in the Live environment until credit card details are added to your account, but you can try the endpoint in the Test environment. Once your billing information is verified, this endpoint can be used in Live. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please go to https://stytch.com/settings/billing to provide billing information.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#billing_not_verified"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

billing_not_verified_for_email

400Bad request

You can only send magic links to emails matching your project's domain until credit card details are added to your account. Once your billing information is verified, emails can be sent to anyone. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please go to billing settings to provide billing information.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "billing_not_verified_for_email",
  "error_message": "You can only send magic links to emails matching your project's domain until credit card details are added to your account. Once your billing information is verified, emails can be sent to anyone. Your first 5,000 monthly active users are free every month, but collecting this information helps us prevent abuse of the platform. Please see https://stytch.com/settings/billing to provide billing information.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#billing_not_verified_for_email"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

breached_password

400Bad request

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/b2b/api/errors/400#breached_password"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_assign_default_rbac_role_id

400Bad request

The default role is implicitly assigned to all members in the project and cannot be explicitly assigned.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_assign_default_rbac_role_id",
  "error_message": "The default role is implicitly assigned to all members in the project and cannot be explicitly assigned.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_assign_default_rbac_role_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_delete_default_sso_connection

400Bad request

Please update the default SSO connection setting for this organization to a different SSO connection before deleting.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_delete_default_sso_connection",
  "error_message": "Please update the default SSO connection setting for this organization to a different SSO connection before deleting.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_delete_default_sso_connection"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_delete_email

400Bad request

Cannot delete the last email for a user with a password. This ensures they can complete a password reset.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_delete_email",
  "error_message": "Cannot delete the last email for a user with a password. This ensures they can complete a password reset.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_delete_email"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_delete_last_primary_factor

400Bad request

You cannot delete the last primary factor (email, phone number, crypto wallet) for a user because that would make their account difficult or impossible to recover. If you want to remove the user from your project, delete the user instead.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_delete_last_primary_factor",
  "error_message": "Cannot delete the last primary factor (email, phone number, crypto wallet) for a user. If you want to delete the user instead, use the DeleteUser endpoint: https://stytch.com/docs/api/delete-user",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_delete_last_primary_factor"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_delete_last_sso_verification_key

400Bad request

Cannot delete the last verification certificate for a connection. Please pass in another one before deleting this one.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_delete_last_sso_verification_key",
  "error_message": "Cannot delete the last verification certificate for a connection. Please pass in another one before deleting this one.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_delete_last_sso_verification_key"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_reset_password_with_existing_password

400Bad request

Cannot reset user's password using their existing password. This could be because their existing password was part of a data breach or to prevent password squatting. Please reset the password via a session or email reset.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_reset_password_with_existing_password",
  "error_message": "Cannot reset user's password using their existing password. This could be because their existing password was part of a data breach or to prevent password squatting. Please reset the password via a session or email reset.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_reset_password_with_existing_password"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

cannot_use_webauthn_with_pending_user

400Bad request

WebAuthn can only be used with active users. To learn more about WebAuthn and user states please see here and here.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cannot_use_webauthn_with_pending_user",
  "error_message": "WebAuthn can only be used for active users. To learn more about WebAuthn and user states read more at https://stytch.com/docs/api/webauthn-overview and https://stytch.com/docs/api/user-states.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#cannot_use_webauthn_with_pending_user"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

client_secret_too_long

400Bad request

Client secret is too long. Please make sure you have the correct value.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "client_secret_too_long",
  "error_message": "Client secret is too long. Please make sure you have the correct value.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#client_secret_too_long"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

custom_claims_too_large

400Bad request

Custom claims are too large.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "custom_claims_too_large",
  "error_message": "Custom claims are too large.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#custom_claims_too_large"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

deprecated_endpoint

400Bad request

This endpoint has been deprecated

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "deprecated_endpoint",
  "error_message": "This endpoint has been deprecated",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#deprecated_endpoint"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_email

400Bad request

A user with the specified email already exists for this project.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_email",
  "error_message": "A user with the specified email already exists for this project.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_email"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_email_for_user

400Bad request

The specified email is already tied to this user.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_email_for_user",
  "error_message": "The specified email is already tied to this user.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_email_for_user"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_email_template_vanity_id

400Bad request

Email template vanity ID already exists.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_email_template_vanity_id",
  "error_message": "Email template vanity ID already exists.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_email_template_vanity_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_m2m_client_id

400Bad request

The client ID submitted is already in use by another client.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_m2m_client_id",
  "error_message": "The client ID submitted is already in use by another client.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_m2m_client_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_member_email

400Bad request

This email already exists for this organization.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_member_email",
  "error_message": "This email already exists for this organization.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_member_email"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_member_phone_number

400Bad request

A member with the specified phone number already exists for this organization.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_member_phone_number",
  "error_message": "A member with the specified phone number already exists for this organization.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_member_phone_number"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_member_phone_number_for_member

400Bad request

A different phone number is already tied to this member.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_member_phone_number_for_member",
  "error_message": "A different phone number is already tied to this member.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_member_phone_number_for_member"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_organization

400Bad request

An organization with the specified name already exists.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_organization",
  "error_message": "An organization with the specified name already exists.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_organization"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_organization_user

400Bad request

A user with the specified email already exists for this organization.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_organization_user",
  "error_message": "A user with the specified email already exists for this organization.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_organization_user"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_project_user

400Bad request

A project user for the specified organization user already exists for this project.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_project_user",
  "error_message": "A project user for the specified organization user already exists for this project.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_project_user"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_redirect_url

400Bad request

A redirect URL already exists for the provided URL.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_redirect_url",
  "error_message": "A redirect URL already exists for the provided URL.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_redirect_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_saml_connection

400Bad request

The SAML connection already exists for this organization and IDP.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_saml_connection",
  "error_message": "The SAML connection already exists for this organization and IDP.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_saml_connection"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_saml_response

400Bad request

This SAML response has already been seen. Please attempt to log in again.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_saml_response",
  "error_message": "This SAML response has already been seen. Please attempt to log in again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_saml_response"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

duplicate_webauthn_registration

400Bad request

The supplied credential ID already exists for this project.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "duplicate_webauthn_registration",
  "error_message": "The supplied credential ID already exists for this project.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#duplicate_webauthn_registration"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

email_jit_provisioning_not_allowed

400Bad request

Email JIT provisioning is not allowed for this organization.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "email_jit_provisioning_not_allowed",
  "error_message": "Email JIT provisioning is not allowed for this organization.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#email_jit_provisioning_not_allowed"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

expired_oauth_response

400Bad request

Too much time has passed since the login flow started. Please attempt to log in again.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "expired_oauth_response",
  "error_message": "Too much time has passed since the login flow started. Please attempt to log in again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#expired_oauth_response"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

expired_oidc_response

400Bad request

Too much time has passed since the login flow started. Please attempt to log in again.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "expired_oidc_response",
  "error_message": "Too much time has passed since the login flow started. Please attempt to log in again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#expired_oidc_response"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

expired_saml_response

400Bad request

Too much time has passed since the login flow started. Please attempt to log in again.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "expired_saml_response",
  "error_message": "Too much time has passed since the login flow started. Please attempt to log in again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#expired_saml_response"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

expired_totp

400Bad request

The TOTP for this user has expired without being verified.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "expired_totp",
  "error_message": "The TOTP for this user has expired without being verified.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#expired_totp"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

failed_saml_response

400Bad request

The user failed to log in to their IDP, or the IDP failed to authenticate the application.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "failed_saml_response",
  "error_message": "The user failed to log in to their IDP, or the IDP failed to authenticate the application.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#failed_saml_response"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

id_token_expired

400Bad request

ID token is expired.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "id_token_expired",
  "error_message": "ID token is expired.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#id_token_expired"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

id_token_incorrect_audience

400Bad request

ID token's audience does not match the OAuth configuration's ID.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "id_token_incorrect_audience",
  "error_message": "ID token's audience does not match the OAuth configuration's ID.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#id_token_incorrect_audience"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

id_token_invalid

400Bad request

ID token is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "id_token_invalid",
  "error_message": "ID token is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#id_token_invalid"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

id_token_nonce_invalid

400Bad request

The provided nonce does not match the nonce in the ID token.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "id_token_nonce_invalid",
  "error_message": "The provided nonce does not match the nonce in the ID token.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#id_token_nonce_invalid"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

inactive_email

400Bad request

The email provided has been marked as inactive by our email provider. This happens most often when the email is undeliverable due to a hard bounce.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "inactive_email",
  "error_message": "The email provided has been marked as inactive by our email provider. This happens most often when the email is undeliverable due to a hard bounce.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#inactive_email"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

indeterminate_sso_connection_for_organization

400Bad request

The organization owns more than one SSO Connection. Please specify the specific connection to be used.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "indeterminate_sso_connection_for_organization",
  "error_message": "The organization owns more than one SSO Connection. Please specify the specific connection to be used.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#indeterminate_sso_connection_for_organization"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

insecure_m2m_client_secret

400Bad request

The client secret submitted is not secure enough. Please generate a more secure secret.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "insecure_m2m_client_secret",
  "error_message": "The client secret submitted is not secure enough. Please generate a more secure secret.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#insecure_m2m_client_secret"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_append_salt

400Bad request

The append_salt value is not supported because it's too long.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_append_salt",
  "error_message": "The append_salt value is not supported because it's too long.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_append_salt"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_argon_2_iteration_amount

400Bad request

The iteration_amount value is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_argon_2_iteration_amount",
  "error_message": "The iteration_amount value is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_argon_2_iteration_amount"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_argon_2_key_length

400Bad request

The key_length value is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_argon_2_key_length",
  "error_message": "The key_length value is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_argon_2_key_length"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_argon_2_memory

400Bad request

The memory value is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_argon_2_memory",
  "error_message": "The memory value is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_argon_2_memory"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_argon_2_salt

400Bad request

The salt value is an unsupported length.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_argon_2_salt",
  "error_message": "The salt value is an unsupported length.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_argon_2_salt"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_argon_2_threads

400Bad request

The threads value is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_argon_2_threads",
  "error_message": "The threads value is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_argon_2_threads"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_argument

400Bad request

Invalid argument.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_argument",
  "error_message": "Invalid argument.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_argument"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_audience_saml_response

400Bad request

The audience in the SAML response is incorrect.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_audience_saml_response",
  "error_message": "The audience in the SAML response is incorrect.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_audience_saml_response"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_authentication_type

400Bad request

The authentication type provided in the header of the request is invalid. The Stytch API uses basic authentication. See more about authenticating Stytch API requests here.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_authentication_type",
  "error_message": "The authentication type provided in the header of the request is invalid. The Stytch API uses basic authentication. See more about authenticating Stytch API requests here: https://stytch.com/docs/api/authentication",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_authentication_type"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_authenticator_type

400Bad request

Invalid authenticator type. The valid values are platform and cross-platform.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_authenticator_type",
  "error_message": "Invalid authenticator type. The valid values are platform and cross-platform.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_authenticator_type"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_authorization_header

400Bad request

The authorization header provided with the request is invalid.

Common causes

  • HTTP request is missing an Authorization header

  • The Authorization header in the HTTP request is not formatted properly

  • The Authorization header in the HTTP request has the incorrect credentials

Troubleshooting steps

  • Check the Authorization header in the HTTP request for proper formatting.

  • Always use the Basic Auth type in the header.

  • Check the project credentials you entered match your API keys in the Dashboard.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_authorization_header",
  "error_message": "The authorization header provided with the request is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_authorization_header"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_authorization_url

400Bad request

Please ensure the length of your authorization_url is less than or equal to 255 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_authorization_url",
  "error_message": "Please ensure the length of your authorization_url is less than or equal to 255 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_authorization_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_base64_scrypt_hash

400Bad request

The provided hash isn't a base64 encoded string. Please base64 encode the hash before passing it to this endpoint.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_base64_scrypt_hash",
  "error_message": "The provided hash isn't a base64 encoded string. Please base64 encode the hash before passing it to this endpoint.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_base64_scrypt_hash"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_base64_scrypt_salt

400Bad request

The provided salt isn't a base64 encoded string. Please base64 encode the salt before passing it to this endpoint.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_base64_scrypt_salt",
  "error_message": "The provided salt isn't a base64 encoded string. Please base64 encode the salt before passing it to this endpoint.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_base64_scrypt_salt"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_bcrypt_cost

400Bad request

The bcrypt cost value is too high, it must be less than 15. If you need a higher cost parameter, please email support@stytch.com.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_bcrypt_cost",
  "error_message": "The bcrypt cost value is too high, it must be less than 15. If you need a higher cost parameter, please email support@stytch.com.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_bcrypt_cost"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_bcrypt_hash

400Bad request

The bcrypt hash passed is not valid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_bcrypt_hash",
  "error_message": "The bcrypt hash passed is not valid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_bcrypt_hash"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_callback_id

400Bad request

The callback URL has an invalid OAuth Callback ID. Please find it in the dashboard at https://stytch.com/dashboard/ and follow the steps there to enter it into the identity provider

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_callback_id",
  "error_message": "The callback URL has an invalid OAuth Callback ID. Please find it in the dashboard at https://stytch.com/dashboard/ and follow the steps there to enter it into the identity provider",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_callback_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_captcha_provider_id

400Bad request

captcha_provider_id format is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_captcha_provider_id",
  "error_message": "captcha_provider_id format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_captcha_provider_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_captcha_provider_type

400Bad request

provider_type should be set to 'GoogleRecaptchaEnterpriseSilentWeb', 'GoogleRecaptchaEnterpriseSilentAndroid', or 'GoogleRecaptchaEnterpriseSilentIOS',.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_captcha_provider_type",
  "error_message": "provider_type should be set to 'GoogleRecaptchaEnterpriseSilentWeb', 'GoogleRecaptchaEnterpriseSilentAndroid', or 'GoogleRecaptchaEnterpriseSilentIOS',.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_captcha_provider_type"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_captcha_threshold

400Bad request

threshold should be in the range 0 to 1 inclusive.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_captcha_threshold",
  "error_message": "threshold should be in the range 0 to 1 inclusive.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_captcha_threshold"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_client_id

400Bad request

Please ensure the length of your client_id is less than or equal to 255 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_client_id",
  "error_message": "Please ensure the length of your client_id is less than or equal to 255 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_client_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_client_secret

400Bad request

Please ensure the length of your client_secret is less than or equal to 512 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_client_secret",
  "error_message": "Please ensure the length of your client_secret is less than or equal to 512 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_client_secret"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_code

400Bad request

Code format is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_code",
  "error_message": "Code format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_code"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_connection_for_jit_provisioning

400Bad request

The SSO connection isn't allowed to create new users according to the organization's JIT provisioning settings.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_connection_for_jit_provisioning",
  "error_message": "The SSO connection isn't allowed to create new users according to the organization's JIT provisioning settings.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_connection_for_jit_provisioning"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_consumer_endpoint

400Bad request

This endpoint is only enabled for consumer projects.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_consumer_endpoint",
  "error_message": "This endpoint is only enabled for consumer projects.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_consumer_endpoint"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_default_url

400Bad request

Thanks for trying Stytch! Replace the default URL with your own to get started. If you haven't already done so, you'll also need to set your magic_link_urls in the dashboard here: https://stytch.com/dashboard/redirect-urls

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_default_url",
  "error_message": "Thanks for trying Stytch! Replace the default URL with your own to get started. If you haven't already done so, you'll also need to set your magic_link_urls in the dashboard here: https://stytch.com/dashboard/redirect-urls",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_default_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_discovery_redirect_url

400Bad request

discovery_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_discovery_redirect_url",
  "error_message": "discovery_redirect_url is invalid. Common issues include using http instead of https or omitting https://.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_discovery_redirect_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_display_name

400Bad request

Please ensure the length of your display name is less than or equal to 128 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_display_name",
  "error_message": "Please ensure the length of your display name is less than or equal to 128 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_display_name"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_domain

400Bad request

Invalid domain, ensure that only the domain was provided. Do not include https:// or a port in this value. Visit the link here for more information about valid domains (called RP ID on the site).

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_domain",
  "error_message": "Invalid domain, ensure that only the domain was provided. Do not include https:// or a port in this value. Visit https://w3c.github.io/webauthn/#rp-id for more information about valid domains (called RP ID on the site).",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_domain"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email

400Bad request

The email address is invalid (i.e. not properly formatted) or missing. Check that the email address is properly formatted and only includes allowed characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email",
  "error_message": "Email format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_for_invites

400Bad request

The email isn't valid within the organization's invite settings.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_for_invites",
  "error_message": "The email isn't valid within the organization's invite settings.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_for_invites"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_for_jit_provisioning

400Bad request

The email isn't valid within the organization's JIT provisioning settings.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_for_jit_provisioning",
  "error_message": "The email isn't valid within the organization's JIT provisioning settings.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_for_jit_provisioning"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_html

400Bad request

email html is not valid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_html",
  "error_message": "email html is not valid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_html"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_id

400Bad request

The email_id is invalid (i.e. not properly formatted) or missing. email-test-81bf03a8-86e1-4d95-bd44-bb3495224953 is an example email_id.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_id",
  "error_message": "email_id format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_plaintext

400Bad request

email plaintext is not valid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_plaintext",
  "error_message": "email plaintext is not valid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_plaintext"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_sandbox

400Bad request

Invalid email. The sanbox@stytch.com email can only be used in the Test environment.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_sandbox",
  "error_message": "Invalid email. The sanbox@stytch.com email can only be used in the Test environment.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_sandbox"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_email_subject

400Bad request

email subject is not valid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_email_subject",
  "error_message": "email subject is not valid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_email_subject"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_expiration

400Bad request

Expiration is invalid, should be between 5 and 10080 minutes.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_expiration",
  "error_message": "Expiration is invalid, should be between 5 and 10080 minutes.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_expiration"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_expiration_otp

400Bad request

expiration_minutes is invalid, should be between 1 and 10 minutes.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_expiration_otp",
  "error_message": "expiration_minutes is invalid, should be between 1 and 10 minutes.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_expiration_otp"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_hash

400Bad request

hash is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_hash",
  "error_message": "hash is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_hash"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_hash_type

400Bad request

The hash_type is invalid. Please check here for a list of supported hash types.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_hash_type",
  "error_message": "hash_type is invalid. Please check https://stytch.com/docs/api/password-migrate for a list of support hash types.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_hash_type"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_id

400Bad request

ID format is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_id",
  "error_message": "ID format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_idp_entity_id

400Bad request

Please ensure the length of your idp_entity_id is less than or equal to 255 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_idp_entity_id",
  "error_message": "Please ensure the length of your idp_entity_id is less than or equal to 255 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_idp_entity_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_idp_sso_url

400Bad request

Please ensure the length of your idp_sso_url is less than or equal to 255 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_idp_sso_url",
  "error_message": "Please ensure the length of your idp_sso_url is less than or equal to 255 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_idp_sso_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_intermediate_session_token_for_organization

400Bad request

The intermediate session token is invalid for the requested organization.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_intermediate_session_token_for_organization",
  "error_message": "The intermediate session token is invalid for the requested organization.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_intermediate_session_token_for_organization"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_invite_redirect_url

400Bad request

invite_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_invite_redirect_url",
  "error_message": "invite_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_invite_redirect_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_ip_address

400Bad request

ip_address format is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_ip_address",
  "error_message": "ip_address format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_ip_address"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_issuer

400Bad request

Please ensure the length of your issuer is less than or equal to 128 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_issuer",
  "error_message": "Please ensure the length of your issuer is less than or equal to 128 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_issuer"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_jwks_url

400Bad request

Please ensure the length of your jwks_url is less than or equal to 255 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_jwks_url",
  "error_message": "Please ensure the length of your jwks_url is less than or equal to 255 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_jwks_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_locale

400Bad request

locale is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_locale",
  "error_message": "locale is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_locale"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_login_oauth_url

400Bad request

login_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_login_oauth_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/b2b/api/errors/400#invalid_login_oauth_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_login_redirect_url

400Bad request

login_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_login_redirect_url",
  "error_message": "login_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_login_redirect_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_login_sso_url

400Bad request

login_redirect_url format is invalid. Common issues include using http instead of https or omitting https://.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_login_sso_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/b2b/api/errors/400#invalid_login_sso_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_m2m_client_scope

400Bad request

The client scope was invalid. Client scopes must be at most 128 characters long and must not contain spaces, backslashes, or quotes.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_m2m_client_scope",
  "error_message": "The client scope was invalid. Client scopes must be at most 128 characters long and must not contain spaces, backslashes, or quotes.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_m2m_client_scope"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_m2m_client_status

400Bad request

The client status sent was invalid. Client statuses must be either 'active' or 'disabled'.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_m2m_client_status",
  "error_message": "The client status sent was invalid. Client statuses must be either 'active' or 'disabled'.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_m2m_client_status"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_md_5_hash

400Bad request

The MD5 hash passed is not valid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_md_5_hash",
  "error_message": "The MD5 hash passed is not valid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_md_5_hash"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_member_get_fields

400Bad request

Please ensure at least one of the following is provided: member_id, email_address.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_member_get_fields",
  "error_message": "Please ensure at least one of the following is provided: member_id, email_address.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_member_get_fields"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_method_id

400Bad request

The method_id is invalid (i.e. not properly formatted) or missing. email-test-81bf03a8-86e1-4d95-bd44-bb3495224953 is an example method_id.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_method_id",
  "error_message": "method_id format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_method_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_microsoft_tenant_type

400Bad request

Only Microsoft Azure Active Directory (AAD) Tenants are permitted to use the Stytch B2B OAuth product. If you are trying to integrate an AAD-B2C account, configure that AAD-B2C tenant as an org-scoped OIDC or SAML connection.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_microsoft_tenant_type",
  "error_message": "Only Microsoft Azure Active Directory (AAD) Tenants are permitted to use the Stytch B2B OAuth product. If you are trying to integrate an AAD-B2C account, configure that AAD-B2C tenant as an org-scoped OIDC or SAML connection.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_microsoft_tenant_type"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_microsoft_user_principal_name

400Bad request

The User Principal Name associated with the login did not have a matching validated domain.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_microsoft_user_principal_name",
  "error_message": "The User Principal Name associated with the login did not have a matching validated domain.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_microsoft_user_principal_name"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_oauth_provider

400Bad request

We didn't recognize the OAuth provider name in the request. Check that the argument is the name of a supported OAuth provider.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_oauth_provider",
  "error_message": "We didn't recognize the OAuth provider name in the request. Check that the argument is the name of a supported OAuth provider.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_oauth_provider"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_allowed_auth_methods

400Bad request

Allowed auth methods can only be 'sso', 'password', 'google_oauth', 'microsoft_oauth', and/or 'magic_link'

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_allowed_auth_methods",
  "error_message": "Allowed auth methods can only be 'sso', 'password', 'google_oauth', 'microsoft_oauth', and/or 'magic_link'",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_allowed_auth_methods"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_auth_factor_setting

400Bad request

The value provided isn't valid. Valid values are 'NOT_ALLOWED', 'RESTRICTED', or 'ALL_ALLOWED'.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_auth_factor_setting",
  "error_message": "The value provided isn't valid. Valid values are 'NOT_ALLOWED', 'RESTRICTED', or 'ALL_ALLOWED'.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_auth_factor_setting"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_auth_factor_setting_for_email_jit_provisioning

400Bad request

Email JIT Provisioning can only be 'NOT_ALLOWED' or 'RESTRICTED', never 'ALL_ALLOWED'

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_auth_factor_setting_for_email_jit_provisioning",
  "error_message": "Email JIT Provisioning can only be 'NOT_ALLOWED' or 'RESTRICTED', never 'ALL_ALLOWED'",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_auth_factor_setting_for_email_jit_provisioning"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_auth_method_settings

400Bad request

Auth methods can only be 'ALL_ALLOWED' or 'RESTRICTED', never 'NOT_ALLOWED'

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_auth_method_settings",
  "error_message": "Auth methods can only be 'ALL_ALLOWED' or 'RESTRICTED', never 'NOT_ALLOWED'",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_auth_method_settings"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_id

400Bad request

organization_id format is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_id",
  "error_message": "organization_id format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_mfa_policy

400Bad request

The value provided isn't valid. Valid values are 'OPTIONAL', or 'REQUIRED_FOR_ALL'.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_mfa_policy",
  "error_message": "The value provided isn't valid. Valid values are 'OPTIONAL', or 'REQUIRED_FOR_ALL'.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_mfa_policy"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_name

400Bad request

Organization name cannot be longer than 128 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_name",
  "error_message": "Organization name cannot be longer than 128 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_name"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_organization_slug

400Bad request

The organization_slug must be at least 2 characters long and may only contain alphanumerics and the reserved characters '-', '.', '_', or '~'. At least one character must be alphanumeric.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_organization_slug",
  "error_message": "The organization_slug must be at least 2 characters long and may only contain alphanumerics and the reserved characters '-', '.', '_', or '~'. At least one character must be alphanumeric.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_organization_slug"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_password_id

400Bad request

password_id format is invalid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_password_id",
  "error_message": "password_id format is invalid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_password_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_password_reset_redirect_url

400Bad request

reset_password_redirect_url is invalid. Common issues include using http instead of https or omitting https://.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_password_reset_redirect_url",
  "error_message": "reset_password_redirect_url is invalid. Common issues include using http instead of https or omitting https://.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_password_reset_redirect_url"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_pbkdf_2_hash

400Bad request

The PBKDF-2 hash passed is not valid.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_pbkdf_2_hash",
  "error_message": "The PBKDF-2 hash passed is not valid.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_pbkdf_2_hash"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_pbkdf_2_iteration_amount

400Bad request

The provided PBKDF-2 iteration_amount value is invalid. Valid range: 512-524288.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_pbkdf_2_iteration_amount",
  "error_message": "The provided PBKDF-2 iteration_amount value is invalid. Valid range: 512-524288.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_pbkdf_2_iteration_amount"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_pbkdf_2_key_length

400Bad request

The provided PBKDF-2 key_length is invalid. Valid range: 8-2048.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_pbkdf_2_key_length",
  "error_message": "The provided PBKDF-2 key_length is invalid. Valid range: 8-2048.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_pbkdf_2_key_length"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_pbkdf_2_salt

400Bad request

The provided PBKDF-2 salt is missing or an invalid length.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_pbkdf_2_salt",
  "error_message": "The provided PBKDF-2 salt is missing or an invalid length.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_pbkdf_2_salt"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_permission_action

400Bad request

All actions used in RBAC role permissions must be defined within their respective resource.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_permission_action",
  "error_message": "All actions used in RBAC role permissions must be defined within their respective resource.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_permission_action"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_permission_resource

400Bad request

All resources used in RBAC role permissions must be defined.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_permission_resource",
  "error_message": "All resources used in RBAC role permissions must be defined.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_permission_resource"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_phone_number

400Bad request

The phone number is invalid, i.e. not properly formatted, or missing.

Common causes

  • If you’re accepting the raw input from a user, they may have included an invalid character, i.e. not a digit.

  • If the phone number is missing from the call, you may not be passing the input from the user to your backend.

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/b2b/api/errors/400#invalid_phone_number"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_phone_number_country_code

400Bad request

The phone number's country code is invalid or not supported.

Common causes

  • SMS to phone numbers outside of the US and Canada is disabled by default for customers who did not use SMS prior to October 2023. If you're interested in sending international SMS, please reach out to support@stytch.com.

  • Regardless of whether or not you are enabled for international SMS, Stytch does not support sending SMS to countries on our Unsupported countries list.

Troubleshooting steps

  • Make sure that the country code you've provided is correctly formatted.

  • Make sure that 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/b2b/api/errors/400#invalid_phone_number_country_code"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_phone_number_docs

400Bad request

Thanks for trying Stytch! Replace the test phone number with a valid one to start sending one-time passcodes.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_phone_number_docs",
  "error_message": "Thanks for trying Stytch! Replace the test phone number with a valid one to start sending one-time passcodes.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_phone_number_docs"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_phone_number_sandbox

400Bad request

Phone number is invalid. The sandbox phone number, +10000000000, can only be used in the Test environment.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_phone_number_sandbox",
  "error_message": "Phone number is invalid. The sandbox phone number, +10000000000, can only be used in the Test environment.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_phone_number_sandbox"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_phpass_hash_format

400Bad request

The phpass hash has an incorrect format as it needs to be exactly 34 characters.

Error

{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_phpass_hash_format",
  "error_message": "The phpass hash has an incorrect format as it needs to be exactly 34 characters.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/400#invalid_phpass_hash_format"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com