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
- 200
Connect token and hosted link
Document ID: DOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken#overview |
| Request | DOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken#request |
| Responses | DOC-IN-tools-connections-apps-api-pipedreamCreateConnectToken#responses |