Skip to main content

Start connecting an app

POST 

/api/v1/integrations/pipedream/create-connect-token

Creates a hosted connection attempt targeted by appSlug and returns its complete connect URL. Validate the parsed URL against the expected provider origin and path for the current attempt, then use it without reconstructing its token query. Treat the URL as a short-lived credential; read expiresAt, avoid caching/sharing it, and create a fresh attempt when appropriate. Do not assume a specific lifetime or single-use property unless qualified for the deployed provider.

For embedding, configure exact allowedOrigins. Correlate the returned state with the attempt initiated by this user; returned state is not authority. A redirect does not establish success: reconcile list-accounts and provider errors.

Request​

Responses​

Connect token and hosted link

Document ID: DOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken. Section identities and revisions.

SectionStable reference
OverviewDOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken#overview
RequestDOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken#request
ResponsesDOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken#responses