invalid_request

Code: invalid_request · Shape: partner

Meaning#

The request failed validation (missing/invalid fields).

Likely causes#

1. Missing required body fields
2. externalUserId empty or longer than 128 characters
3. Invalid UUID where an id is required
4. OAuth start missing client_id / redirect_uri / PKCE fields
5. Non-S256 code_challenge_method

How to diagnose#

• Read message / error_description from the response body
• Compare request body to the API Reference for the operation

How to fix#

• Correct the request fields and retry once.
• Use SDK helpers so required fields are typed.

Retry behavior#

Safe to retry after fixing the payload.

Related#

API: POST /v1/identities/status, POST /v1/identities/enroll, POST /oauth/authorize/init, POST /verify/start

SDK: enable2FA(), createVerification(), verify()

Troubleshooting: network, pkce

Guides: Partner 2FA Quickstart, OAuth Quickstart