Skip to content

Commit fc02347

Browse files
Update workflows.mdx
1 parent 48ea0d6 commit fc02347

File tree

1 file changed

+18
-2
lines changed

1 file changed

+18
-2
lines changed

docs-v2/pages/connect/workflows.mdx

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -265,9 +265,13 @@ You have two options for triggering workflows that run on behalf of your end use
265265

266266
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.
267267

268+
<Callout type="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+
268272
To get started, you'll need:
269273

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
271275
- Your [project ID](/projects/#finding-your-projects-id)
272276
- Your workflow's HTTP endpoint URL
273277
- 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
362366

363367
See the [API documentation](/connect/api/#deploy-a-trigger) for detailed examples of deploying and managing triggers.
364368

369+
## OAuth client requirements
370+
371+
<Callout type="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+
365381
## Troubleshooting
366382

367383
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} \
385401
Pipedream Connect Error: Required account for hubspot not found for external user ID abc-123 in development
386402
```
387403
388-
389404
### Common errors
405+
390406
#### No external user ID passed, but one or more steps require it
391407
- 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.
392408
- [Refer to the docs](#invoke-the-workflow) to make sure you're passing external user ID correctly when invoking the workflow.

0 commit comments

Comments
 (0)