OAuth2 redirect callback

GET

/api/integrations/oauth/{providerSlug}/callback

Public redirect endpoint that the provider sends the user back to after consent. Exchanges the authorization code for tokens, stores the encrypted connection for the tenant encoded in the state, then redirects the browser back to the dashboard. This endpoint is invoked by the browser, not called directly by API clients, and is not authenticated by an API key.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Query Params

Responses

🔵302

Redirect back to the dashboard integrations page with a connected or error query parameter. On success: ?connected={providerSlug}. On failure: ?error={reason} (e.g. missing_params, invalid_state, provider_not_found, token_exchange_failed, integration_not_configured, save_failed, unknown).

Headers

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/integrations/oauth//callback?code=&state=&error=' \
--header 'X-API-Key: <api-key>'

Modified at 2026-07-08 19:01:40

Start an OAuth2 authorization flow

List actions for a provider