Kobotoolbox for Forms
Last updated
Was this helpful?
Last updated
Was this helpful?
We host our own instance of at .
To request an account, join the slack channel #infrastructure-kobo-toolbox and ask there
The above-mentioned slack channel also serves as a communication channel for announcing maintenance periods and for asking general questions about the service
Users are managed by _super admins _in the administrative backend which is available at .
Here, admins can create and delete users and manage other settings of the Kobo instance (but most of which should be just left alone).
Important: this is not where you give access to individual surveys etc. This is done in the User Interface at .
Go to .
Add user
Click on "Add" next to "Users" and you can set a user name and password for the new user.
Important: User names should follow the {firstname}_{first letter of surname} format. Using dots (".") in user names definetly causes some weird problems, so this should be avoided at all cost. The password should obviously follow good password principles.
Once you click on "Save", you'll be redirected to the settings page for this user. Leave the default settings and click "Save" again.
Associate Email address to user
Since an update to a newer version, we have to associate an email address to the user, otherwise the login will not work. To do that:
top right, click add email address.
A pop up will appear where you can select the target user by clicking on their name
the pop up should close. The displayed number is the numeric ID for the user you selected.
enter the email address and check both tick boxes (Verified and Primary)
Share the password with the user
In the dropdown at the bottom, select "CorrelAid" if it is not already selected.
Click "POST"
When creating a new project, you can use the template surveys by selecting "Use a template" in the "Create project" dialogue. This will copy the template survey into your project.
Kobo has an API you can use.
You can find the documentation here:
go to Email addresses:
next to "User" there is a . Click on it.
Adding the email will not send out an automated invitation. To share the password with the new user, you can use a (make sure to change the expiration date to one week).
We have created the public CorrelAid collection which you can see when going to and selecting "Public collections" in the bar on the left. The collection provides template surveys and question blocks for questions that we ask. In order to use the questions and template surveys in this collection, you need to "subscribe" to it. Unfortunately, there is a in the frontend of Kobo - the "Subscribe" button does not work. However, there is a workaround:
Open .
If you go back to , the CorrelAid collection should now be in your personal library and you can use the questions and/or the template surveys.
version 2: -> current version of the API - covers getting data, uploading forms etc.
version 1: (should only rarely be used) -> upload data to existing forms
You can find your token in your user settings: