OAuth

The following endpoints allow you to connect data sources that require the user to log in on their own portal. See the OAuth guide.

📄️Start an OAuth session

Starts an OAuth session to create an integration with a data source that requires the user to log in on its own portal. Open the returned `oauthUrl` in the user's browser. The session expires after 15 minutes.

📄️Get an OAuth session result

Returns the outcome of a completed OAuth session. Results are kept 5 minutes after completion; `404` before completion or after expiry.

📄️Re-authenticate an integration via OAuth

Starts an OAuth session to renew the data source tokens of an existing integration, e.g. after the data source revoked them. Reuses the integration's data source and credentials. On success, the existing integration is reactivated.

📄️Get integration setup links

Returns data source pages where the user completes the integration setup, e.g. choosing which John Deere organizations are shared with Hiboo.

📄️OAuth callback

Called by the data source's browser redirect, not by your application. Registered as `https://ingest.hiboo.io/oauth/callback`.