You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs-v2/pages/connect/workflows.mdx
+18-2Lines changed: 18 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -265,9 +265,13 @@ You have two options for triggering workflows that run on behalf of your end use
265
265
266
266
The most common way to trigger workflows is via HTTP webhook. We strongly recommend [creating a Pipedream OAuth client](/rest-api/auth#creating-an-oauth-client) and authenticating inbound requests to your workflows.
267
267
268
+
<Callouttype="info">
269
+
This section refers to authenticating requests to the Pipedream API. For info on how managed auth works for your end users, refer to the [managed auth quickstart](/connect/managed-auth/quickstart).
270
+
</Callout>
271
+
268
272
To get started, you'll need:
269
273
270
-
-[OAuth client ID and secret](/rest-api/auth#creating-an-oauth-client)(optional but recommended)
274
+
-[OAuth client ID and secret](/rest-api/auth#creating-an-oauth-client)for authenticating with the Pipedream API
271
275
- Your [project ID](/projects/#finding-your-projects-id)
272
276
- Your workflow's HTTP endpoint URL
273
277
- The [external user ID](/connect/api/#external-users) of your end user
@@ -362,6 +366,18 @@ You can [programmatically deploy triggers via the API](/connect/api/#deploy-a-tr
362
366
363
367
See the [API documentation](/connect/api/#deploy-a-trigger) for detailed examples of deploying and managing triggers.
364
368
369
+
## OAuth client requirements
370
+
371
+
<Callouttype="info">
372
+
When using OAuth apps (like Google Drive, Slack, Notion, etc.) with your end users, you **must use your own custom OAuth clients**.
373
+
</Callout>
374
+
375
+
1. Register your own OAuth application with each third-party service (Google Drive, Slack, etc.)
376
+
2.[Add your OAuth client credentials to Pipedream](/apps/oauth-clients#configuring-custom-oauth-clients)
377
+
3. Make sure to include your `oauthAppId` when connecting accounts for your end users
378
+
379
+
For detailed instructions, see the [OAuth Clients documentation](/connect/managed-auth/oauth-clients#using-a-custom-oauth-client).
380
+
365
381
## Troubleshooting
366
382
367
383
For help debugging issues with your workflow, you can return verbose error messages to the caller by configuring the HTTP trigger to **Return a custom response from your workflow**.
@@ -385,8 +401,8 @@ curl -X POST https://{your-endpoint-url} \
385
401
Pipedream Connect Error: Required account forhubspot not found for external user ID abc-123in development
386
402
```
387
403
388
-
389
404
### Common errors
405
+
390
406
#### No external user ID passed, but one or more steps require it
391
407
- 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.
392
408
- [Refer to the docs](#invoke-the-workflow) to make sure you're passing external user ID correctly when invoking the workflow.
0 commit comments