What do you need help with?
Search the knowledge base, browse our resources, and visit our forum for more detailed information
Search the knowledge base, browse our resources, and visit our forum for more detailed information
Last updated: 6 Sep 2023
The KoboToolbox Integration allows users to easily synchronize their project data from a KoboToolbox project to a monday.com board. In just a few steps you can set up the integration to automatically copy data submissions received in KoboToolbox to any of your monday.com boards. This integration significantly reduces the manual work involved in copy-pasting project data between the two platforms.
Simplified process of connecting KoboToolbox projects with monday.com boards
Easy mapping of monday.com fields to KoboToolbox questions using any label language defined in the form
Real-time synchronization of newly created submissions to create new items
Create an account on KoboToolbox if you don’t have one yet. Use this guidance to set up your free account.
Prepare a monday.com board mirroring the structure of your KoboToolbox project so that all fields from your KoboToolbox project are represented on a monday.com board.
During the application setup of the integration, there is a need to authenticate access to your account by providing your KoboToolbox API token. To get your API token, use any of the methods described here.
Install the KoboToolbox integration from monday.com apps marketplace.
Once installed, go to your previously prepared board to set up the integration. Note: Only one KoboToolbox integration recipe can be established per monday board.
Go to the integration menu on the top right.
Find KoboToolbox in the Integrations Center.
Click on the integration and choose the included recipe.
On the next step authorize your KoboToolbox app into monday.com platform by providing the following data
Select the appropriate server
There are two public KoboToolbox servers: the Global Server at kf.kobotoolbox.org and the European Union Server at eu.kobotoolbox.org.
2. Provide your API key prepared earlier
Note: In order to change the API key after the integration recipe setup, KoboToolbox Integration app should be completely reinstalled or user should delete all integrations installed by this user.
For recipe configuration, set up the following parameters
Choose the appropriate KoboToolbox project from the dropdown. Only deployed projects are available for selection
Choose the label language from the dropdown. If your form contains more than one language, select the one that should be used to map questions to columns. The selected language will only be displayed to map KoboToolbox questions with monday.com columns. The data displayed in the monday.com board will always use the underlying XML data structure instead of translated Select One or Select Multiple labels.
Click “Item” to set up the mapping of questions to columns .
Once you are done with the recipe configuration, click the “Add to Board”
button.
Now that you have the integration in place, there is a last step to configure REST Server on the KoboToolbox side. This is required to tell your KoboToolbox project to automatically forward data to monday.com. To do that, execute the following steps:
Copy the integration link from the notification message sent to you on
successful integration setup. The same link is added to the board
description, so you can get it from there as well.
Log into your KoboToolbox account
Go to the appropriate project. Then open the Settings tab, choose REST
Services, and click on ‘Register a new service’ button
Enter “monday.com integration” as the Service Name and paste the previously copied integration link in the “Endpoint URL” field.
In the “Custom HTTP Headers” section, insert the value “webhook-auth” in
the “Name” field and put your Kobo API token in the “Value” field.
Click the ‘Create’ button.
That’s all! Now each new submission to the KoboToolbox project will be automatically be added to your monday.com board according to your recipe configuration.\
Notes:
Any updates made to a form or individual submission in KoboToolbox project which is already sent to monday.com board will not be automatically synced at this point. Such changes like removing or renaming a question, changing group hierarchy, changing a group to a repeat group, or editing labels in the KoboToolbox form will not affect the items on monday.com board.
Due to monday.com limitations there is no way to map a column with Location type in the dynamic fields mapping. To overcome this limitation the following workflow should be established
a. Create two columns on monday.com board for location data to be populated - one of the Text type and second of the Location type. It’s important to name them identically.
b. Use a location column of the Text type in the dynamic fields mapping. Second column of the Location type would be automatically populated once the first one is filled out.
What is the REST Service?
More information about REST Services could be found in the following guidance.
What is the dynamic fields mapping?
Dynamic fields mapping is a pairing of fields represented on the monday.com board with the appropriate questions from the KoboToolbox project.
What happens if I change my data in the Kobo account?
Any updates made to a form or individual submission in KoboToolbox project which is already sent to monday.com board will not be automatically synced at this point.
What happens if I change my data on the monday.com board?
Changes made to data represented on the monday.com board will not be reflected in the KoboToolbox project.
What happens if I need to later change the language?
Language selection affects only the dynamic fields mapping view on integration recipe configuration step. Board data will not be translated.
What happens if I delete the board on Kobo?
If a project is deleted in Kobo, the integration would not run until the integration recipe is updated with a new project.
How do multiple select questions on Kobo transfer to monday?
For multi select questions a column with Dropdown type should be used on monday.com board to have all selected options correctly transferred to the board.
How do single select questions on Kobo transfer to monday?
For single select questions columns with Dropdown or Text types can be used to have the selected option correctly transferred to the board.
What column types from Kobo shift to what column types from monday?
All column types except File and External XML are supported by monday.com. If you can’t find the appropriate column type on monday.com board, use a column with Text type. For the Point and Area Kobo column type, it’s better to use the Text column on monday side despite the fact that there is Location column type for this matter.
Can I sync more than one KoboToolbox project with my monday board?
No; only one KoboToolbox integration recipe can be established per board. Having more than one recipe will lead to a server error.
Did you find what you were looking for? Was the information clear? Was anything missing?
Share your feedback to help us improve this article!
KoboToolbox is maintained by Kobo Inc.