401 errors

Send us an email

Ask in Slack

cname_invalid_for_http_only_cookies

401

Unauthorized

You didn't provide a valid CNAME with your HTTP-only cookies setting set to 'ENFORCED'. Consider updating the HTTP-only cookies setting to 'ENABLED' or making a request via the project's configured CNAME.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cname_invalid_for_http_only_cookies",
  "error_message": "You didn't provide a valid CNAME with your HTTP-only cookies setting set to 'ENFORCED'. Consider updating the HTTP-only cookies setting to 'ENABLED' or making a request via the project's configured CNAME.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#cname_invalid_for_http_only_cookies"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

cname_required_for_http_only_cookies

401

Unauthorized

You may not make a request via 'api.stytch.com' with your HTTP-only cookies setting set to 'ENFORCED'. Consider updating the HTTP-only cookies setting to 'ENABLED' or making a request via the project's configured CNAME.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cname_required_for_http_only_cookies",
  "error_message": "You may not make a request via 'api.stytch.com' with your HTTP-only cookies setting set to 'ENFORCED'. Consider updating the HTTP-only cookies setting to 'ENABLED' or making a request via the project's configured CNAME.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#cname_required_for_http_only_cookies"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

endpoint_not_authorized_for_sdk

401

Unauthorized

The project owner hasn’t authorized the Stytch SDK to call endpoints for this product.

Common causes

You haven’t yet configured your Stytch project to allow SDK access to this product.

Troubleshooting steps

Enable the product via the SDK configuration tab in the Stytch Dashboard.
If you’re using our WebAuthn product, you’ll also need to enable “Manage user data” via the SDK configuration tab.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "endpoint_not_authorized_for_sdk",
  "error_message": "The project owner has not authorized the SDK to call this endpoint. Please enable it in the dashboard to continue: https://stytch.com/dashboard/sdk-configuration.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#endpoint_not_authorized_for_sdk"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

enterprise_endpoint

401

Unauthorized

Thanks for trying Stytch! We're glad you're excited to try our new products, but this one requires approval before using. Please reach out to support@stytch.com if you're interested.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "enterprise_endpoint",
  "error_message": "Thanks for trying Stytch! We're glad you're excited to try our new products, but this one requires approval before using. Please reach out to support@stytch.com if you're interested.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#enterprise_endpoint"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

idp_client_supplied_redirect_url_not_found_in_client

401

Unauthorized

The redirect URL supplied in the request is not registered to the client.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "idp_client_supplied_redirect_url_not_found_in_client",
  "error_message": "The redirect URL supplied in the request is not registered to the client.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#idp_client_supplied_redirect_url_not_found_in_client"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

insufficient_factors

401

Unauthorized

User must be logged in with multiple categories of factors to call this endpoint.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "insufficient_factors",
  "error_message": "User must be logged in with multiple categories of factors to call this endpoint.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#insufficient_factors"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

oauth_unverified_email

401

Unauthorized

The user has not verified their email with the OAuth provider. Please encourage them to verify their email address and try again.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "oauth_unverified_email",
  "error_message": "The user has not verified their email with the OAuth provider. Please encourage them to verify their email address and try again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#oauth_unverified_email"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

oidc_response_unverified_email

401

Unauthorized

The user has not verified their email with the external provider. Please encourage them to verify their email address and try again.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "oidc_response_unverified_email",
  "error_message": "The user has not verified their email with the external provider. Please encourage them to verify their email address and try again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#oidc_response_unverified_email"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

session_too_old_to_reset_password

401

Unauthorized

The provided session cannot be used to reset a password. It does not have an authentication_factor that was authenticated within the last 5 minutes. Please prompt the user to authenticate again before retrying the endpoint.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "session_too_old_to_reset_password",
  "error_message": "The provided session cannot be used to reset a password. It does not have an authentication_factor that was authenticated within the last 5 minutes. Please prompt the user to authenticate again before retrying the endpoint.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#session_too_old_to_reset_password"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

stale_factors

401

Unauthorized

In order to call this endpoint, the user should have authenticated within the last hour. Please reauthenticate and try again.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "stale_factors",
  "error_message": "In order to call this endpoint, the user should have authenticated within the last hour. Please reauthenticate and try again.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#stale_factors"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

too_many_m2m_clients_for_billing_tier

401

Unauthorized

You have exceeded the maximum number of M2M clients for your billing tier.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_m2m_clients_for_billing_tier",
  "error_message": "You have exceeded the maximum number of M2M clients for your billing tier.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#too_many_m2m_clients_for_billing_tier"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

too_many_sso_connections_for_billing_tier

401

Unauthorized

You have exceeded the maximum SSO connections for your billing tier.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_sso_connections_for_billing_tier",
  "error_message": "You have exceeded the maximum SSO connections for your billing tier.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#too_many_sso_connections_for_billing_tier"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

twitter_401

401

Unauthorized

Twitter responded with a 401 Unauthorized error.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "twitter_401",
  "error_message": "Twitter responded with a 401 Unauthorized error.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#twitter_401"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_auth_impersonation_token

401

Unauthorized

The impersonation token could not be authenticated.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_auth_impersonation_token",
  "error_message": "The impersonation token could not be authenticated.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_auth_impersonation_token"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_auth_magic_link

401

Unauthorized

The magic link could not be authenticated because it was either used or expired.

Common causes

A user clicks a magic link they already used before
A user waits too long to click a magic link that has expired

Troubleshooting steps

Send a new magic link to the user

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_auth_magic_link",
  "error_message": "The magic link could not be authenticated because it was either already used or expired. Send another magic link to this user.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_auth_magic_link"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_auth_otp_code

401

Unauthorized

The passcode could not be authenticated because it was either already used or expired. Send another passcode to this user.

Common causes

The user may have inadvertently entered the same OTP code twice; either re-using a code they already authenticated or an expired code.
If you wrapped the OTPAuthenticate call in a useEffect and you are using React 18 in StrictMode, you may be double calling the method. See here for more details.

Troubleshooting steps

Review your code, and network requests (if using a frontend SDK) to determine if multiple requests are being made.
Send a new code to the user.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_auth_otp_code",
  "error_message": "The passcode could not be authenticated because it was either already used or expired. Send another passcode to this user.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_auth_otp_code"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_auth_password_reset_token

401

Unauthorized

The password reset token could not be authenticated, try sending another password reset email to the user.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_auth_password_reset_token",
  "error_message": "The password reset token could not be authenticated, try sending another password reset email to the user.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_auth_password_reset_token"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_auth_webauthn_registration

401

Unauthorized

WebAuthn registration could not be authenticated.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_auth_webauthn_registration",
  "error_message": "WebAuthn registration could not be authenticated.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_auth_webauthn_registration"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_authenticate_recovery_code

401

Unauthorized

Unable to authenticate recovery code.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_authenticate_recovery_code",
  "error_message": "Unable to authenticate recovery code.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_authenticate_recovery_code"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unable_to_authenticate_totp

401

Unauthorized

Unable to authenticate TOTP.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unable_to_authenticate_totp",
  "error_message": "Unable to authenticate TOTP.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unable_to_authenticate_totp"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unauthorized_action

401

Unauthorized

Unauthorized action.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_action",
  "error_message": "Unauthorized action.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unauthorized_action"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unauthorized_billing_permissions

401

Unauthorized

This action or feature is not supported by your billing tier. Please visit https://stytch.com/dashboard/settings/pricing-plans for more information.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_billing_permissions",
  "error_message": "This action or feature is not supported by your billing tier. Please visit https://stytch.com/dashboard/settings/pricing-plans for more information.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unauthorized_billing_permissions"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unauthorized_credentials

401

Unauthorized

The provided credentials (project_id and secret) were invalid, an incorrect password was provided to an Authenticate Password request, or an invalid/expired session token was included in a request.

Common causes

Working with multiple Stytch projects results in the project_id and secret getting mixed up
Improper clearing of revoked session cookies

Troubleshooting steps

Compare the secret and project_id you are using the the values in the Stytch dashboard.
Confirm that the password provided to our Authenticate Password endpoint was correct, or prompt the user to reset their password
Confirm the secret and project_id are associated within the same project
Generate a new secret for your project_id in the Stytch dashboard
Ensure that there are no expired/invalid session tokens being included in requests

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials",
  "error_message": "Unauthorized credentials.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unauthorized_credentials"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unauthorized_credentials_homepage

401

Unauthorized

Thanks for trying Stytch! Replace the project ID and secret with your credentials from the developer dashboard to start adding users. To get started, sign up here: https://stytch.com/login

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials_homepage",
  "error_message": "Thanks for trying Stytch! Replace the project ID and secret with your credentials from the developer dashboard to start adding users. To get started, sign up here: https://stytch.com/login",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unauthorized_credentials_homepage"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unauthorized_project_id_live

401

Unauthorized

Unauthorized credentials. Looks like the project ID supplied in the request was a live project id. Try using a test project id when hitting test.stytch.com.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_project_id_live",
  "error_message": "Unauthorized credentials. Looks like the project ID supplied in the request was a live project id. Try using a test project id when hitting test.stytch.com.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unauthorized_project_id_live"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unauthorized_project_id_test

401

Unauthorized

Unauthorized credentials. Looks like the project ID supplied in the request was a test project id. Try using a live project id when hitting stytch.com.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_project_id_test",
  "error_message": "Unauthorized credentials. Looks like the project ID supplied in the request was a test project id. Try using a live project id when hitting stytch.com.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unauthorized_project_id_test"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

unavailable_endpoint

401

Unauthorized

Thanks for trying Stytch! We're glad you're excited to try our new products, but this one is still under construction. Please reach out to support@stytch.com if you're interested.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unavailable_endpoint",
  "error_message": "Thanks for trying Stytch! We're glad you're excited to try our new products, but this one is still under construction. Please reach out to support@stytch.com if you're interested.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#unavailable_endpoint"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

user_unauthenticated

401

Unauthorized

User must have an active Stytch session to call this method. Have you logged in yet?

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "user_unauthenticated",
  "error_message": "User must have an active Stytch session to call this method. Have you logged in yet?",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#user_unauthenticated"
}

How to get help

Visit our forum

Send us an email

Ask in Slack

weak_factor_combination

401

Unauthorized

This session does not contain a strong combination of factors.

Error

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "weak_factor_combination",
  "error_message": "This session does not contain a strong combination of factors.",
  "error_url": "https://stytch.com/docs/b2b/api/errors/401#weak_factor_combination"
}

How to get help

Visit our forum

Send us an email

Ask in Slack