Native triggers docs

docs-v2/pages/connect/api.mdx

@@ -2011,6 +2011,10 @@ curl -X POST "https://api.pipedream.com/v1/connect/{your_project_id}/actions/run
 
 #### Deploy a trigger
 
+<Callout type="info">
+See [here](/connect/components/#deploying-triggers) for more info on supported trigger types with example payloads
+</Callout>
+
 Deploy a trigger component that will emit events to a webhook or workflow for a Pipedream Connect user.
 
 ```text
@@ -2492,14 +2496,14 @@ curl -X GET \
 Retrieve a single deployed trigger for a given user.
 
 ```text
-GET /deployed-triggers/{deployed_component_id}/
+GET /deployed-triggers/{deployed_trigger_id}/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -2590,7 +2594,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 
 curl -X GET \
   -G \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \
@@ -2677,14 +2681,14 @@ curl -X GET \
 Delete deployed trigger for a given user.
 
 ```text
-DELETE /deployed-triggers/{deployed_component_id}/
+DELETE /deployed-triggers/{deployed_trigger_id}/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -2768,7 +2772,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 
 curl -X DELETE \
   -G \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \
@@ -2787,14 +2791,14 @@ Pipedream returns a `204 No Content` response on successful deletion
 Retrieve a list of the last events that a deployed trigger emitted.
 
 ```text
-GET /deployed-triggers/{deployed_component_id}/events/
+GET /deployed-triggers/{deployed_trigger_id}/events/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -2889,7 +2893,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 
 curl -X GET \
   -G \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/events" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/events" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \
@@ -2984,14 +2988,14 @@ curl -X GET \
 Retrieve the list of webhook URLs listening to a deployed trigger.
 
 ```text
-GET /deployed-triggers/{deployed_component_id}/webhooks/
+GET /deployed-triggers/{deployed_trigger_id}/webhooks/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -3081,7 +3085,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 
 curl -X GET \
   -G \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/webhooks/" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/webhooks/" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \
@@ -3105,14 +3109,14 @@ curl -X GET \
 Update the list of webhook URLs that will listen to a deployed trigger.
 
 ```text
-PUT /deployed-triggers/{deployed_component_id}/webhooks/
+PUT /deployed-triggers/{deployed_trigger_id}/webhooks/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -3220,7 +3224,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 # This request will update the list of webhook URLs listening to the specified deployed trigger.
 
 curl -X PUT \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/webhooks/" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/webhooks/" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \
@@ -3244,14 +3248,14 @@ curl -X PUT \
 Retrieve the list of workflow IDs listening to a deployed trigger.
 
 ```text
-GET /deployed-triggers/{deployed_component_id}/workflows/
+GET /deployed-triggers/{deployed_trigger_id}/workflows/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -3341,7 +3345,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 
 curl -X GET \
   -G \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/workflows/" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/workflows/" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \
@@ -3366,14 +3370,14 @@ curl -X GET \
 Update the list of workflows that will listen to a deployed trigger.
 
 ```text
-PUT /deployed-triggers/{deployed_component_id}/workflows/
+PUT /deployed-triggers/{deployed_trigger_id}/workflows/
 ```
 
 ##### Path parameters
 
-`dcid` **string**
+`deployed_trigger_id` **string**
 
-The deployed component ID for the trigger you'd like to retrieve.
+The deployed trigger ID for the trigger you'd like to retrieve (ex, `dc_xxxxxxx`, `hi_xxxxxxx`, `ti_xxxxxxx`, or `ei_xxxxxxx`).
 
 ##### Query parameters
 
@@ -3482,7 +3486,7 @@ curl -X POST https://api.pipedream.com/v1/oauth/token \
 # This request will update the list of webhook URLs listening to the specified deployed trigger.
 
 curl -X PUT \
-  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{dcid}/webhooks/" \
+  "https://api.pipedream.com/v1/connect/{your_project_id}/deployed-triggers/{deployed_trigger_id}/webhooks/" \
   -H "Authorization: Bearer {access_token}" \
   -H "Content-Type: application/json" \
   -H "x-pd-environment: development" \

docs-v2/pages/connect/components.mdx

@@ -812,3 +812,181 @@ retrieve, or update the source in the future.
 Refer to the [full Connect API reference](/connect/api#components) for questions and additional examples.
 
 </Steps>
+
+## Deploying triggers
+
+These are 2 categories of triggers you can deploy on behalf of your end users:
+- [App-based event sources](#app-based-event-sources)
+- [Native triggers](#native-triggers)
+
+<Callout type="info">
+Refer to the [full Connect API reference](/connect/api/#deploy-a-trigger) to list, retrieve, delete, and manage triggers for your user
+</Callout>
+
+### App-based event sources
+- Listen for events that occur in other systems: for example, when [a new file is added to Google Drive](https://pipedream.com/apps/google-drive/triggers/new-files-instant) or when [a new contact is created in HubSpot](https://pipedream.com/apps/hubspot/triggers/new-or-updated-contact)
+- Deploying these triggers requires that your customers first connect their account using [Pipedream Connect Managed Auth](/managed-auth/quickstart), since the triggers are deployed on their behalf using account
+- Refer to the [quickstart above](#deploying-a-source) to get started 
+
+### Native triggers
+- You can also deploy native triggers, which don't require any authentication from your end users, so **you should skip the account connection process when configuring these triggers**
+- Because these triggers don't use a connected account from your end users, APIs to deploy and manage them are slightly different (see below)
+
+#### HTTP Webhook
+Generate a unique HTTP webhook URL for your end users to configure in any other upstream service.
+
+<Tabs items={['Node.js', 'HTTP (cURL)']}>
+<Tabs.Tab>
+```javascript
+const { data: deployedTrigger } = await pd.deployTrigger({
+  externalUserId: "abc-123",
+  id: "http-new-requests",
+  webhookUrl: "https://events.example.com/http-new-requests"
+});
+
+const {
+  id: triggerId,              // The unique ID of the deployed trigger
+  endpoint_url: endpointUrl,  // The endpoint URL to return to the user
+} = deployedTrigger;
+
+// Parse and return the data you need
+```
+</Tabs.Tab>
+<Tabs.Tab>
+```bash
+curl -X POST https://api.pipedream.com/v1/connect/{project_id}/components/triggers/deploy \
+  -H "Content-Type: application/json" \
+  -H "X-PD-Environment: {environment}" \
+  -H "Authorization: Bearer {access_token}" \
+  -d '{
+    "external_user_id": "abc-123",
+    "id": "http-new-requests",
+    "webhook_url": "https://events.example.com/http-new-requests"
+  }'
+
+# Parse and return the data you need
+```
+</Tabs.Tab>
+</Tabs>
+
+##### Example response
+
+```json
+{
+  "id": "hi_zbGHMx",
+  "key": "xxxxxxxxxx",
+  "endpoint_url": "http://xxxxxxxxxx.m.pipedream.net",
+  "custom_response": true,
+  "created_at": 1744508049,
+  "updated_at": 1744508049
+}
+```
+
+#### Schedule
+Deploy a timer to act as a cron job that will emit an event on a custom schedule you or your users define.
+
+<Tabs items={['Node.js', 'HTTP (cURL)']}>
+<Tabs.Tab>
+```javascript
+const { data: deployedTrigger } = await pd.deployTrigger({
+  externalUserId: "abc-123",
+  id: "schedule-custom-interval",
+  configuredProps: {
+    "cron": {
+      "intervalSeconds": 900
+    }
+  },
+  webhookUrl: "https://events.example.com/schedule-custom-interval"
+});
+
+const {
+  id: triggerId,              // The unique ID of the deployed trigger
+  endpoint_url: endpointUrl,  // The endpoint URL to return to the user
+} = deployedTrigger;
+
+// Parse and return the data you need
+```
+</Tabs.Tab>
+<Tabs.Tab>
+```bash
+curl -X POST https://api.pipedream.com/v1/connect/{project_id}/components/triggers/deploy \
+  -H "Content-Type: application/json" \
+  -H "X-PD-Environment: {environment}" \
+  -H "Authorization: Bearer {access_token}" \
+  -d '{
+    "external_user_id": "abc-123",
+    "id": "schedule-custom-interval",
+    "configured_props": {
+      "cron": {
+        "intervalSeconds": 900
+      }
+    },
+    "webhook_url": "https://events.example.com/schedule-custom-interval"
+  }'
+
+# Parse and return the data you need
+```
+</Tabs.Tab>
+</Tabs>
+
+##### Example response
+
+```json
+{
+  "id": "ti_aqGTJ2",
+  "interval_seconds": 900,
+  "cron": null,
+  "timezone": "UTC",
+  "schedule_changed_at": 1744508391,
+  "created_at": 1744508391,
+  "updated_at": 1744508391
+}
+```
+
+#### New emails received 
+Generate a unique email address for your customers to emit events to
+
+<Tabs items={['Node.js', 'HTTP (cURL)']}>
+<Tabs.Tab>
+```javascript
+const { data: deployedTrigger } = await pd.deployTrigger({
+  externalUserId: "abc-123",
+  id: "email-new-email",
+  webhookUrl: "https://events.example.com/email-new-email"
+});
+
+const {
+  id: triggerId,              // The unique ID of the deployed trigger
+  email_address: emailAddress,  // The unique email address to return to the user
+} = deployedTrigger;
+
+// Parse and return the data you need
+```
+</Tabs.Tab>
+<Tabs.Tab>
+```bash
+curl -X POST https://api.pipedream.com/v1/connect/{project_id}/components/triggers/deploy \
+  -H "Content-Type: application/json" \
+  -H "X-PD-Environment: {environment}" \
+  -H "Authorization: Bearer {access_token}" \
+  -d '{
+    "external_user_id": "abc-123",
+    "id": "email-new-email",
+    "webhook_url": "https://events.example.com/email-new-email"
+  }'
+
+# Parse and return the data you need
+```
+</Tabs.Tab>
+</Tabs>
+
+##### Example response
+
+```json
+{
+  "id": "ei_QaJTb0",
+  "email_address": "[email protected]",
+  "created_at": 1744499847,
+  "updated_at": 1744499847
+}
+```