Skip to content
v3.0.1 — MCP OAuth, organizations, passkeys, SSR adaptersChangelog
Convex Auth
Esc
↑↓navigate↵open⌘Jpreview

OAuth provider callback (registered redirect URI)

The URL you register with each OAuth provider (https://<deployment>.convex.site/api/auth/callback/google). Exchanges the authorization code, validates signed state, then 302s to the validated callbackURL — or errorURL on failure.

GET/api/auth/callback/{provider}
Path parameters
providerstringrequired
Query parameters
codestring
statestring
errorstring
error_descriptionstring
Responses
302

Redirect to the validated app URL

400

Invalid body or an untrusted redirect parameter.

successbooleanrequired
Allowed:false
reasonstringrequired
Try it
Server
Parameters
Request
curl -X GET 'https://your-deployment.convex.site/api/auth/callback/string'
Response
Redirect to the validated app URL