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/components.mdx
+100-1Lines changed: 100 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1011,4 +1011,103 @@ curl -X POST https://api.pipedream.com/v1/connect/{project_id}/components/trigge
1011
1011
"created_at": 1744499847,
1012
1012
"updated_at": 1744499847
1013
1013
}
1014
-
```
1014
+
```
1015
+
1016
+
## Troubleshooting
1017
+
1018
+
### Referencing the app prop in configured props payload
1019
+
1020
+
If you encounter an error like `Cannot read properties of undefined (reading 'oauth_access_token')`, it's likely related to an incorrect reference to the app prop in your configured_props payload.
1021
+
1022
+
For example, using `google_sheets` instead of `googleSheets`, or `stripe` instead of `app`. Always use the exact app prop name that's returned in the component definition.
1023
+
1024
+
The app prop name can be found in the component's definition under `configurable_props`:
1025
+
1026
+
```json
1027
+
"configurable_props": [
1028
+
{
1029
+
"name": "googleSheets", // Use this exact name in your payload
1030
+
"type": "app",
1031
+
"app": "google_sheets"
1032
+
},
1033
+
...
1034
+
]
1035
+
```
1036
+
1037
+
### Passing dynamic props ID
1038
+
1039
+
When working with components that use dynamic props, you must track and pass the `dynamicPropsId` in your API calls. After calling the API to reload props as described in the [Configure dynamic props](#configure-dynamic-props) section, you'll receive a response containing a `dynamicProps.id` value that looks like `dyp_6xUyVgQ`.
1040
+
1041
+
This ID must be included in subsequent API calls to `runAction` or `deployTrigger`. Failing to include it can result in errors like:
1042
+
1043
+
```json
1044
+
{
1045
+
"name": "Error",
1046
+
"message": "undefined is not an array or an array-like"
1047
+
}
1048
+
```
1049
+
1050
+
or
1051
+
1052
+
```json
1053
+
{
1054
+
"title": "TypeError",
1055
+
"detail": "Cannot read properties of undefined (reading 'endpoint')"
1056
+
}
1057
+
```
1058
+
1059
+
For example, after receiving the dynamic props ID from the reload props call, include it in your action execution:
1060
+
1061
+
```javascript
1062
+
// First, reload props for a component with dynamic props
Remember to maintain this ID in your application state while the user is configuring the component, and include it in all subsequent API calls related to that particular configuration.
1091
+
1092
+
### Checking source logs for deployed triggers
1093
+
1094
+
If a deployed trigger isn't emitting events as expected, you can examine the source logs to get a better sense of what's happening.
1095
+
1096
+
Use the following URL to access logs and view emitted events:
1097
+
```
1098
+
https://pipedream.com/sources/{dcid}
1099
+
```
1100
+
1101
+
Replace `{dcid}` with your deployed component ID (e.g., `dc_dAuGmW7`).
1102
+
1103
+
The sources UI contains three tabs:
1104
+
1105
+
-**Events**: Lists emitted events from the deployed trigger that will be sent to the subscribed webhook or workflow. This helps you verify that events are being properly processed and understand their structure.
1106
+
1107
+
-**Logs**: Displays execution history for the trigger. For polling sources, this shows each time the trigger checks for updates. For webhook-based instant sources, it shows each time the source receives an event from the upstream API. This tab is especially useful for troubleshooting when events aren't being emitted as expected.
1108
+
1109
+
-**Configuration**: Provides a read-only view of the deployed source's code and configuration. While you can't modify settings for deployed triggers that belong to external users here, this tab offers insight into how the trigger is configured.
1110
+
1111
+
<Callouttype="info">
1112
+
This UI view is currently in beta and has some limitations. Some UI elements may appear unpolished, and the configuration tab has limited functionality.
0 commit comments