Actions17
Overview
This node interacts with KoboToolbox, a platform for data collection via forms. Specifically, the "Hook" resource with the "Get Many" operation allows users to retrieve multiple webhook configurations associated with a particular form.
Use cases include:
- Monitoring all webhooks set up on a specific KoboToolbox form.
- Automating workflows that depend on webhook configurations, such as auditing or managing integrations.
- Fetching webhook details in bulk to analyze or update them programmatically.
For example, you might use this node to get all hooks of a form to verify which external services are currently receiving submission notifications.
Properties
| Name | Meaning |
|---|---|
| Form Name or ID | The identifier of the KoboToolbox form whose hooks you want to retrieve. Choose from a list or specify an ID using an expression. |
| Return All | Boolean flag indicating whether to return all webhook results or limit the number returned. |
| Limit | Maximum number of webhook results to return if "Return All" is false. |
Output
The node outputs an array of JSON objects representing webhook configurations for the specified form. Each object corresponds to one webhook and contains its details as provided by the KoboToolbox API.
If binary data were involved (not applicable here), it would be included in a separate binary property, but for this operation, output is purely JSON.
Dependencies
- Requires an active connection to KoboToolbox via an API key credential configured in n8n.
- Uses the KoboToolbox REST API endpoints under
/api/v2/assets/{formId}/hooks/. - The node depends on internal helper functions to make authenticated API requests and load form options dynamically.
Troubleshooting
- No hooks returned: Ensure the specified form ID is correct and that webhooks exist for that form.
- API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Limit ignored or too few results: If "Return All" is false, the node respects the "Limit" property; increase the limit or enable "Return All" to fetch more.
- Invalid form ID error: Double-check the form ID or use the dropdown to select a valid form.
- Network or timeout issues: Confirm network connectivity to KoboToolbox and retry later if the service is temporarily unavailable.