I agree Our site saves small pieces of text information (cookies) on your device in order to deliver better content and for statistical purposes. You can disable the usage of cookies by changing the settings of your browser. By browsing our website without changing the browser settings you grant us permission to store that information on your device.
A guide of how to connect Kobo to HXLDash and setting up an automatically updating dashboard and workflow with no code
HXLDash will be connected to Kobo via a tool called the HXLProxy.
Kobo collects and stores the data
HXLProxy moves the data (and can apply transforms and analysis) to HXLDash
HXLDash visualises the data
The data in this workflow will update every 4 hours
Before starting, you will need the following:
An account on https://kobo.humanitarianresponse.info
A Kobo survey with HXL hashtags defined for at least one question
Some data in the survey
Go to https://kobo.humanitarianresponse.info/#/account-settings. Click on the eye-shaped icon to make the API token visible. You need to do this only once: your API token will be the same for every survey associated with your account.
Browse to your survey in Kobo and copy the URL. It should be of a similar format to
Paste your survey link into the HXL Proxy.
The HXL Proxy will detect that the link for Kobo and bring up the saved recipe screen. In the box labeled Authorisation Token enter your kobo API key. Please make sure your write it in the format TOKEN <API KEY> as seen in the image below.
You will also have to enter a recipe name and a password. The password is specific to the recipe, not to you, and there is no way to retrieve it if you lose it.
The next step is to use the HXL Proxy to apply filters to your data. This could be to aggregate your data to a level that is safe to share or you could filter out sensitive columns such as contact details. To see more ways the HXL proxy please see the HXL Proxy use case page.
Please note that data from HXL Proxy to HXLDash is public, so the data has to be aggregated and sensitive data removed to a level that safe.
Copy the URL for the data from the HXL Proxy.
Paste this link into HXLDash and then you are ready to create a dashboard in HXLDash with data automatically flowing from Kobo.