Actions17
Overview
This node integrates with KoboToolbox, a platform for data collection via forms and submissions. Specifically, the Update Validation Status operation under the Submission resource allows users to update the validation status of a particular submission within a form.
Typical use cases include:
- Automatically marking survey responses as approved or rejected based on external validation logic.
- Managing workflow states by setting submissions "On Hold" pending further review.
- Integrating KoboToolbox data validation into broader automation pipelines, e.g., triggering notifications or follow-up actions when a submission's validation status changes.
Example: After processing survey data externally, you can update the submission’s validation status to "Approved" to indicate it passed quality checks.
Properties
| Name | Meaning |
|---|---|
| Form Name or ID | The identifier of the form containing the submission. Choose from a list or specify an ID manually. |
| Submission ID | The unique numeric ID of the submission to update. |
| Validation Status | The desired validation state to set for the submission. Options are: |
| - Approved | |
| - Not Approved | |
| - On Hold |
Output
The output is a JSON array containing the updated submission validation status object returned by the KoboToolbox API after the PATCH request. This typically includes fields confirming the new validation status and related metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the KoboToolbox API using an API key credential configured in n8n.
- The node uses internal helper functions to make authenticated HTTP requests to KoboToolbox endpoints.
- The
formIdmust correspond to an existing form accessible by the API credentials. - The
submissionIdmust be valid and belong to the specified form.
Troubleshooting
- Invalid Form or Submission ID: If the form or submission ID does not exist or is inaccessible, the API will return an error. Verify IDs and permissions.
- Authentication Errors: Ensure the API key credential is correctly configured and has sufficient rights.
- Validation Status Value: Only the predefined validation statuses ("Approved", "Not Approved", "On Hold") are accepted. Using invalid values will cause errors.
- Network Issues: Connectivity problems may cause request failures; check network access to the KoboToolbox API.
- API Rate Limits: Excessive requests might be throttled by KoboToolbox; consider adding delays or retries.
Common error messages usually originate from the API and indicate issues like unauthorized access, resource not found, or bad request due to invalid parameters.