Integrations

Create Connection Session Token

Mint a short-lived token for the hosted OAuth flow.

The token is what a browser hands to the connection provider to run the consent screen; this call does not connect anything by itself. The result of that flow comes back to POST /integrations/connections.

The body is optional - omit it to take the app's default provider.

post/integrations/connections/session-token

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/connections/session-token
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

providerstring nullable

Stable graph8 provider name.

provider_config_keystring nullable

Provider config key on the connection provider.

Response

Successful Response

dataConnectionPayload required

An open envelope for a connection, a token or a migration report.

Open because the migration STATUS payload carries a per-entity progress map, a discovered-field map and a pipeline list that all grow with the providers - and because a dropped warning on a migration report reads as "nothing went wrong".

Changes

No recorded changes to this operation across all 2 revisions of this API.