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_4RfjXN
Success and error redirect URLs
To automatically redirect users somewhere after they complete the connection flow (or if an error occurs), define the success_redirect_uri
and error_redirect_uri
parameters during token creation. 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.