Skip to main content
GET/gate/idp/{provider}/callback

Receive OAuth Callback

Receives the authorization code and state from the identity provider after an end user authenticates.

The state must be one this project issued for this provider.

The gateway exchanges the code with the provider, resolves or provisions the end user, and redirects to the app's redirectUri with a single-use code in the fragment, valid for 60 seconds.

No session exists yet: the page gets one from POST /@{projectSlug}/gate/idp/exchange.

Failures redirect with error and error_description in the fragment.

Parameters
provider *path
projectSlug *path

The project's slug: the path segment after @.

It is unique within the org.

Responses
HTTPK9O CodeDescription
400K9O_INVALID_FIELD_VALUEThe project path segment does not resolve to a live project, so it is rejected as an invalid project identifier.
502K9O_IDP_FEDERATION_FAILEDThe identity provider returned a response that could not be validated or exchanged for a platform session.
cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/gate/idp/google/callback'

Showing example in cURL

More in Federation