Connect Link
Connect Link provides a Pipedream-hosted link that lets you connect third-party accounts without any frontend implementation in your app.
When to use Connect Link
If you aren't able to execute JavaScript or open an iFrame in your frontend, or you want to send users a URL to connect accounts via email or SMS, use Connect Link. That URL opens a Pipedream-hosted page that guides the user through the account connection flow. The URL is scoped to the specific end user, and expires after 4 hours.
How to generate a link
See the Connect quickstart for a full tutorial for getting Connect up and running.
Here's a quick overview of how to generate a Connect Link URL:
- First, generate a token for your users.
- Extract the
connect_link_url
from the token response. - Before returning the URL to your user, add an
app
parameter to the end of the query string:
https://pipedream.com/_static/connect.html?token={token}&connectLink=true&app={appSlug}
- Redirect your users to this URL, or send it to them via email, SMS, and more.
To test this code, check out this workflow: https://pipedream.com/new?h=tch_EvfbvQ
Success and error redirect URLs
When you generate a Connect link, you can specify success_redirect_url
and error_redirect_url
parameters. Pipedream will redirect the end user to these URLs after they complete the connection flow, or if an error occurs. See the API docs for details.
In the absence of these URLs, Pipedream will redirect the user to a Pipedream-hosted success or error page at the end of the connection flow.