KoboToolbox 2 icon

KoboToolbox 2

Work with KoboToolbox forms and submissions

Actions17

Overview

This node interacts with KoboToolbox, a platform for data collection via forms and submissions. Specifically, the Submission Delete operation allows users to delete a particular submission from a specified form. This is useful in scenarios where erroneous or outdated submission data needs to be removed from the dataset.

Practical examples:

  • Removing test or dummy submissions before final data analysis.
  • Deleting duplicate or invalid entries submitted by mistake.
  • Automating cleanup of submissions based on certain criteria through workflows.

Properties

Name Meaning
Form Name or ID The identifier of the form from which the submission will be deleted. Can be selected from a list or provided as an expression.
Submission ID The unique numeric identifier of the submission to delete.

Output

The output JSON contains a single object indicating the success of the deletion operation:

[
  {
    "success": true
  }
]

This confirms that the submission was successfully deleted. There is no binary data output for 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 user must have appropriate permissions to delete submissions on the specified form.

Troubleshooting

  • Common issues:

    • Providing an incorrect or non-existent Form ID or Submission ID will cause the API request to fail.
    • Insufficient permissions or invalid API credentials will result in authorization errors.
    • Network connectivity problems can prevent successful communication with the KoboToolbox API.

  • Error messages and resolutions:

    • "No file found matching name ..." — Not applicable here but similar errors may occur if IDs are wrong; verify the Form and Submission IDs.
    • API error responses such as 404 (Not Found) indicate the submission or form does not exist.
    • 401 or 403 errors indicate authentication or permission issues; check API credentials and user rights.
    • Timeout or network errors suggest connectivity problems; ensure stable internet access.

Links and References

Discussion