Skip to content
Enjoy complimentary data migration when switching from your existing bookkeeper or CPA to Institution.
AI connections and developer tools

Fix an incomplete developer-app authorization request

Check the registered redirect, PKCE method, and request parameters in the app’s OAuth flow.

Updated 2026-11-11

If the authorization page reports that the request is incomplete or invalid, the app developer should inspect the OAuth URL that initiated the flow. Customers should restart from the app rather than editing its parameters manually.

The documented flow uses response_type=code, the client ID, an exact registered redirect URI, space-separated scopes, state, a PKCE code challenge, and code_challenge_method=S256. Duplicate query parameters are rejected by the authorization page.

Use a fresh PKCE verifier and matching challenge for each authorization and retain them with state in the server session. Verify returned state before exchanging the code. The callback must match a registered public HTTPS redirect rather than an arbitrary destination.

If the page instead says the app is unavailable, check the app’s current configuration, review state, and company eligibility. Keep client secrets out of authorization URLs and browser logs. Provide support with the app ID and safe error wording rather than a complete callback containing a short-lived authorization code.

Was this article helpful?

Tell us whether this answered the question you came with.

Related articles

Still stuck?

Tell us what you were trying to do and where it went wrong. If you are already a client, you can also open a support case from Help and support in your workspace.

We confirm who you are before we change anything on an account.