The source connector for Typeform allows you to stream form responses to any data sink in real-time and transform them on the way.
This source connector supports the following configuration options:
The personal access token from your Typeform account. When creating a new token please make sure that the token has been assigned to the following scopes: read forms and read responses.
If you are managing different workspaces in Typeform, you may provide a workspace id here to only retrieve forms of a certain workspace.
The id of the form that shall be consumed. Given that the form is available under the URI https://[account_name].typeform.com/to/rddGwBRA the id would be rddGwBRA.
You may retrieve the list of forms available in your Typeform account by clicking on Fetch available forms.
The interval in milliseconds between requests made by DataCater to the Typeform REST API to retrieve new responses that have been created since the last request (default: 60000).
The interval in milliseconds between requests made by DataCater to the Typeform REST API to retrieve new responses, when catching up because not all new responses could be retrieved at the previous request (default: 30000).
When importing forms into DataCater, DataCater creates the following fixed attributes:
| Attribute name | DataCater data type | Description |
|---|---|---|
| response_id | String | The id of the response, which is unique per form but not unique globally. |
| landed_at | String | The time when the user landed at the form. In ISO 8601 format, UTC time, to the second, with T as a delimiter between the date and time. |
| submitted_at | String | The time when the form response was submitted. In ISO 8601 format, UTC time, to the second, with T as a delimiter between the date and time. |
| metadata_user_agent | String | The user agent of the user. |
| metadata_platform | String | The platform of the user, derived from the user agent. |
| metadata_referer | String | The referer URI. |
| metadata_network_id | String | The IP of the user. |
| metadata_browser | String | The browser of the user. |
In addition to the fixed attributes, DataCater creates one attribute for each question of the form. DataCater uses the Question reference of each question as the attribute name. By default, question references are randomly-generated alphanumeric values. However, after the first publishing of your form, you may change the question references to custom values to allow a better identification of attributes in DataCater. The data type of the attribute in DataCater depends on the type of the question in Typeform:
| Typeform question type | DataCater data type |
|---|---|
| Multiple Choice | List[String] |
| Phone Number | String |
| Short Text | String |
| Long Text | String |
| Statement | Ignored, no attribute will be created. |
| Picture Choice | List[String] |
| Yes/No | Boolean |
| Opinion Scale | Long |
| Rating | Long |
| Date | String |
| Number | Long |
| Dropdown | String |
| Legal | Boolean |
| File Upload | String |
| Payment | String |
| Website | String |