KoboToolbox
Read KoboToolbox forms, submissions, REST hooks and asset files (KPI API v2).
OCNORA ships 9 typed KoboToolbox operations and 1 trigger. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run.
Before you connect KoboToolbox
- Authentication
- API key
- Credential
- the KoboToolbox API tokenthe API token, or {"api_key": "…"}
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
- Prerequisites
- The token needs edit rights on the form — a token that can read submissions can still fail to create a REST Service. Publishing also needs MANTLE_APP_PUBLIC_BASE_URL set to an https URL the KoBo server can reach; KoBo refuses an http endpoint and blocks private addresses.
Prerequisites are taken from the connection notes in this provider’s node contracts; each node’s reference page says which apply to it.
What you can do with KoboToolbox
Operations, grouped by what they do to your data, plus 1 trigger that start a run.
Create and send 2
Read and search 6
Delete and cancel 1
A sample KoboToolbox workflow
- 1New Submissiontrigger.kobotoolbox_eventStart a run when a KoboToolbox form receives a new submission.
- 2Get Formkobotoolbox.get_formRetrieve one form with its settings, deployment state and content.
- 3Upload Filekobotoolbox.create_fileUpload a media file or map layer onto a form, sent as base64 text.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Operations 9
- Upload FileUpload a media file or map layer onto a form, sent as base64 text.kobotoolbox.create_file
- Create HookAdd a REST service so KoboToolbox posts every new submission on a form to a URL, which is how a Mantle webhook trigger receives them.kobotoolbox.create_hook
- Delete SubmissionPermanently delete one submission from a form.kobotoolbox.delete_submission
- Get FormRetrieve one form with its settings, deployment state and content.kobotoolbox.get_form
- Get SubmissionRetrieve one submission of a form by its numeric id or its rootUuid.kobotoolbox.get_submission
- List FilesList the media files and map layers attached to a form.kobotoolbox.list_files
- List FormsList the forms and projects the API token can reach, one page at a time.kobotoolbox.list_forms
- List HooksList the REST services a form forwards its submissions to.kobotoolbox.list_hooks
- List SubmissionsList a form's submissions, optionally filtered by a MongoDB-style query.kobotoolbox.list_submissions
KoboToolbox questions
- How does OCNORA authenticate with KoboToolbox?
- With a stored API key credential, shaped the KoboToolbox API token or the API token, or {"api_key": "…"}. A connection test can check it when you add it.
- What can I automate with KoboToolbox?
- 9 typed operations and 1 trigger, each with a reference page listing its config fields and the shapes it emits.
- What if the KoboToolbox operation I need is not listed?
- Where KoboToolbox has an HTTP API, call it from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use KoboToolbox?
- Not yet. Start from a blank workflow, or describe the workflow to Build with AI.
- How are KoboToolbox calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
More in Business apps
See your first KoboToolbox workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.