Skip to content

Commit 9c2e2e9

Browse files
Adding known limitations (#15000)
1 parent 6acf667 commit 9c2e2e9

File tree

3 files changed

+34
-14
lines changed

3 files changed

+34
-14
lines changed

docs-v2/pages/connect/troubleshooting.mdx

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
1+
import Callout from '@/components/Callout'
2+
13
# Troubleshooting
24

35
Below are some common errors when connecting your users' accounts via Pipedream Connect.
46

57
### Error creating a Connect token
68

7-
_Error creating token: Error: Failed to obtain OAuth token: Response Error: 401 Unauthorized_
9+
>Error creating token: Error: Failed to obtain OAuth token: Response Error: 401 Unauthorized
810
911
Authorization to the Pipedream API failed when creating the Connect token. Double-check the client ID or secret for your [Pipedream OAuth client](/connect/api#authentication).
1012

1113
### Error connecting an account
1214

1315
Most errors when connecting an account are related to the [Connect token](/connect/tokens), which Pipedream validates from the Connect iFrame.
1416

15-
#### Possible errors
17+
#### Common errors
1618

17-
_This link has expired. Please request a new one from the app developer._
19+
>This link has expired. Please request a new one from the app developer.
1820
19-
_This session has expired. Please refresh the page to try again._
21+
>This session has expired. Please refresh the page to try again.
2022
2123
#### Troubleshooting steps
2224

@@ -32,14 +34,18 @@ and check the response for error messages.
3234

3335
#### Token validation errors
3436

35-
_The Pipedream Connect token is invalid. Please generate a new one and try again._
37+
>The Pipedream Connect token is invalid. Please generate a new one and try again.
3638
3739
Connect tokens expire, and are only able to be used once. Try generating a new token and try again.
3840

39-
_App not found. Please check your app id._
41+
>App not found. Please check your app id.
4042
4143
Double-check the app slug you're passing [when connecting your user's account](/connect/quickstart#connect-your-users-account).
4244

4345
### Connection failed. Please retry or contact support.
4446

45-
The user may have closed the OAuth popup window without completing authorization.
47+
The user may have closed the OAuth popup window without completing authorization.
48+
49+
<Callout type="info">
50+
If you're still have trouble or hitting an error that isn't listed here, [get in touch with us](https://pipedream.com/support). We'd love to help.
51+
</Callout>

docs-v2/pages/connect/workflows.mdx

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -277,6 +277,7 @@ curl -X POST https://{your-endpoint-url} \
277277
Pipedream Connect Error: Required account for hubspot not found for external user ID abc-123 in development
278278
```
279279
280+
280281
### Common errors
281282
#### No external user ID passed, but one or more steps require it
282283
- One or more steps in the workflow are configured to **Use end user's auth via Connect**, but no external user ID was passed when invoking the workflow.
@@ -292,4 +293,18 @@ Pipedream Connect Error: Required account for hubspot not found for external use
292293
293294
#### Running workflows for your users in production requires a higher tier plan
294295
- Anyone is able to run workflows for your end users in `development`. The Business plan is required to run on behalf of `production` users.
295-
- Schedule a call with our sales team and learn more about pricing [here](https://pipedream.com/pricing?plan=Enterprise).
296+
- Schedule a call with our sales team and learn more about pricing [here](https://pipedream.com/pricing?plan=Enterprise).
297+
298+
## Known limitations
299+
300+
#### Using your end user's auth is not currently supported within control flow segments
301+
- Currently, you can only use your end user's auth in the linear execution paths of a Pipedream workflow.
302+
- You can still use control flow features in your Connect-enabled workflow, but the step(s) that use an end user's auth must be in the linear [execution path](/workflows/control-flow#execution-path) of the workflow.
303+
304+
#### Workflows can only use a single external user's auth per execution
305+
- Right now you cannot invoke a workflow to loop through many external user IDs within a single execution.
306+
- You can only run a workflow for a single external user ID at a time (for now).
307+
308+
#### The external user ID to use during execution must be passed in the triggering event
309+
- You can't run a workflow on a timer for example, and look up the external user ID to use at runtime.
310+
- The external user ID must be passed in the triggering event, typically via [HTTP trigger](#invoke-the-workflow).

pnpm-lock.yaml

Lines changed: 5 additions & 6 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)