Actions17
Overview
This node integrates with KoboToolbox, a platform for data collection via forms. Specifically, the Form - Get operation retrieves detailed information about a single form by its ID or name. This is useful when you want to fetch metadata or configuration details of a specific form stored in KoboToolbox.
Common scenarios include:
- Fetching form structure or settings before processing submissions.
- Verifying form existence and details dynamically in workflows.
- Using form metadata to conditionally branch logic or enrich data processing.
Example: You have a workflow that processes survey results but first needs to confirm the form's schema or status by retrieving the form details using this node.
Properties
| Name | Meaning |
|---|---|
| Form Name or ID | The unique identifier or name of the form to retrieve. Choose from a dropdown list or specify via expression. |
Output
The output is a JSON array where each item represents the full details of the requested form as returned by the KoboToolbox API endpoint /api/v2/assets/{formId}.
The JSON object typically includes metadata such as:
- Form UID
- Title and description
- Creation and modification timestamps
- Deployment status
- Other form-specific configuration fields
No binary data is output for this operation.
Dependencies
- Requires an active connection to KoboToolbox via an API key credential configured in n8n.
- The node uses the internal helper method to make authenticated HTTP requests to KoboToolbox API endpoints.
- The "Form Name or ID" property supports dynamic loading of available forms via an internal method.
Troubleshooting
Error: No form found matching the specified ID or name
Ensure the form ID or name is correct and accessible with your API credentials. Use the dropdown to select existing forms or verify the expression used.Authentication errors
Confirm that the API key credential is valid and has sufficient permissions to access form assets.Network or timeout issues
Check network connectivity to the KoboToolbox API and retry if necessary.
Links and References
- KoboToolbox API Documentation
- n8n Expressions Documentation (for using expressions in properties)