Typeform
On This Page
Typeform is an online survey management solution. You can use Typeform for free, or use one of the paid plans which offer more features. It provides a web-based platform that allows you to easily create surveys, forms, apps, and quizzes. The typeforms you create are stored and organized in workspaces. You can add multiple workspaces in your account, and categorize your typeforms accordingly.
Hevo uses the Typeform API to replicate the data present in your Typeform account to the desired Destination database or data warehouse for scalable analysis. Refer to section, Data Model for the list of supported objects.
Typeform uses OAuth 2.0 to identify Hevo and authorize the request for accessing account data.
Prerequisites
-
An active Typeform account from which data is to be ingested exists.
-
You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.
Configuring Typeform as a Source
Perform the following steps to configure Typeform as the Source in your Pipeline:
-
Click PIPELINES in the Navigation Bar.
-
Click + CREATE PIPELINE in the Pipelines List View.
-
In the Select Source Type page, select Typeform.
-
In the Configure your Typeform account page, click + ADD TYPEFORM ACCOUNT.
-
Sign in using your Typeform credentials.
-
Click Accept to authorize Hevo to access your Typeform account.
-
In the Configure your Typeform Source page, specify the following:
-
Pipeline Name: A unique name for your Pipeline, not exceeding 255 characters.
-
Authorized Account (Non-editable): This field is automatically populated based on the email address you entered earlier when connecting to your Typeform account.
-
-
Click TEST & CONTINUE.
-
Proceed to configuring the data ingestion and setting up the Destination.
Data Replication
| For Teams Created | Default Ingestion Frequency | Minimum Ingestion Frequency | Maximum Ingestion Frequency | Custom Frequency Range (in Hrs) |
|---|---|---|---|---|
| Before Release 2.21 | 1 Hr | 1 Hr | 24 Hrs | 1-24 |
| After Release 2.21 | 6 Hrs | 30 Mins | 24 Hrs | 1-24 |
Note: The custom frequency must be set in hours as an integer value. For example, 1, 2, or 3 but not 1.5 or 1.75.
-
Historical Data: In the first run of the Pipeline, Hevo ingests all the existing data for the selected objects from your Typeform account and loads it to the Destination.
-
Incremental Data: Once the historical load is complete, all new and updated records for the Responses object are ingested as per the ingestion frequency. The remaining objects are ingested in Full Load mode.
Schema and Primary Keys
Hevo uses the following schema to upload the records in the Destination database:
Data Model
The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:
| Object | Mode | Description |
|---|---|---|
| Workspaces | Full Load | Contains the list of all workspaces that you have access to. |
| Forms | Full Load | Contains details of all the digital surveys or questionnaires in your Typeform account. |
| Responses | Incremental | Contains details about the response data provided by a user, including the fields in the form. |
| Themes | Full Load | Contains the list of of pre-designed styles and design settings that you can apply to your forms. It includes fonts, colors, background images, and other design elements. |
Additional Information
Read the detailed Hevo documentation for the following related topics:
Source Considerations
-
Pagination: An API call for each Typeform object fetches one page with up to 200 records.
-
Rate Limit: Typeform imposes a limit of 2 API calls per second per token per account. If the limit is exceeded, Hevo defers the ingestion till the limits reset.
Limitations
-
Hevo currently does not support deletes for Typeform. Therefore, any data deleted in the Source may continue to exist in the Destination.
-
Hevo does not provide you the option to select the workspace from which you want to ingest data. Hevo ingests data for all the workspaces in your account.
-
Hevo does not provide you with the option to select the historical sync duration for loading historical data. All the historical data in your Typeform account is loaded.
Revision History
Refer to the following table for the list of key updates made to this page:
| Date | Release | Description of Change |
|---|---|---|
| Mar-05-2024 | 2.21 | Updated the ingestion frequency table in the Data Replication section. |
| Apr-04-2023 | NA | Updated section, Configuring Typeform as a Source to update the information about historical sync duration. |
| Mar-09-2023 | 2.09 | Updated the page to reflect changes to the Typeform configuration. |
| May-24-2022 | 1.89 | New document. |