Typeform Integration

Connect Typeform to feed survey forms and responses into the BuildBetter Surveys workspace

Connect Typeform to BuildBetter to import forms and responses into the Surveys workspace, where you can browse, filter, and analyze survey feedback alongside calls, support conversations, and other customer data.

Typeform is the primary source for BuildBetter Surveys today. Once a form is connected, its responses appear in the Surveys section and feed signal extraction, dashboards, and AI chat just like any other feedback source.

Overview

The Typeform integration:

• Imports Typeform forms as surveys in the Surveys workspace
• Syncs responses in real-time via webhooks
• Bulk-imports historical responses on connect
• Extracts signals (feature requests, complaints, ratings) from open-text answers
• Powers cross-source analysis combining survey data with calls and conversations

Integration Type: One-way import (Typeform → BuildBetter) Authentication: API key Sync Method: Real-time webhooks + historical import

Features

• API Key Authentication: Connect with a Typeform personal access token
• Form Import: Import forms with all questions and logic
• Real-Time Sync: Webhook-based response import as submissions occur
• Historical Import: Bulk import past responses on connect
• Question Type Support: All Typeform question types supported
• Response Tracking: Track submissions with timestamps and metadata
• Per-Form Control: Select which forms to sync
• Surveys Workspace Integration: Responses appear in the BuildBetter Surveys section for browsing, filtering, and analysis

Setup Guide

Prerequisites

1. Typeform Requirements:

   • Active Typeform account
   • Forms with responses (or ready to receive responses)
   • Permission to generate a personal access token with form, response, and webhook scopes

2. BuildBetter Requirements:

   • Active BuildBetter account
   • Admin privileges for integration setup

Quick Setup

1. Generate a Typeform API key

   In Typeform, go to Account → Personal tokens and create a token with permission to read forms, read responses, and manage webhooks. Copy and save the token securely.

2. Connect in BuildBetter

   Go to Settings → Integrations in BuildBetter, find Typeform, and click Connect. Paste your API key and save.

3. Select forms to sync

   BuildBetter loads your list of Typeform forms. Select the forms you want to import. You can change this selection any time.

4. Automatic webhook setup

   BuildBetter automatically creates webhooks for each selected form so new responses sync in real time. Historical responses are imported in the background on first connect.

Once forms are connected, head to the Surveys workspace in BuildBetter to browse and filter responses. Survey responses also feed signals, dashboards, and AI chat.

Supported Question Types

All Typeform question types are supported:

Typeform Type	BuildBetter Type	Description
Short Text	Text	Short text responses
Long Text	Text	Long-form text responses
Multiple Choice	Single Select	Single choice questions
Picture Choice	Single Select	Image-based choices
Dropdown	Single Select	Dropdown selections
Yes/No	Boolean	Boolean responses
Opinion Scale	Rating	Rating scale questions
Rating	Rating	Star ratings
Email	Email	Email addresses
Number	Number	Numeric responses
Date	Date	Date selections
File Upload	File URL	Uploaded file URLs
Website	URL	Website URLs

How It Works

Initial Setup Flow

1. Admin generates a Typeform personal access token
2. Token is stored securely in BuildBetter as an integration secret
3. User selects which forms to sync
4. Webhooks are created for each selected form
5. Historical responses are imported in the background

Real-Time Sync

1. User submits a Typeform response
2. Typeform fires a webhook to BuildBetter
3. The response is processed and stored in the Surveys workspace
4. Data becomes available for browsing, filtering, and signal extraction immediately

Data Structure

Forms are imported with:

• Form ID, title, and type
• Creation and update timestamps
• Form language
• Welcome and thank you screens
• Question logic and settings

Responses include:

• Response ID and token
• Submission timestamp
• Individual answers to each question
• Hidden fields and calculated scores
• Metadata (landing page, referrer, etc.)

Required Token Scopes

When generating your Typeform personal access token, include at minimum:

• forms:read — Read your forms and their structure
• responses:read — Read form responses
• webhooks:read — View existing webhooks
• webhooks:write — Create and manage webhooks

Configuration Options

Per-Form Control

• Select which forms to sync individually
• Enable/disable forms without disconnecting the integration
• Historical import runs in the background for each newly connected form

Webhook Management

• Webhooks are automatically created for connected forms
• Tagged with bb-{formId} for identification
• SSL verification enabled by default
• Webhooks are removed when forms are disconnected from BuildBetter

Imported Data

Forms

• Form structure and questions
• Question validation rules
• Logic jumps and branching
• Themes and settings

Responses

• Complete response data
• Answer text, numbers, choices
• File upload URLs
• Email addresses and contact info
• Hidden fields
• Response metadata

Analytics

• Submission timestamps
• Response completion status
• Calculated scores (if configured)
• Response source (landing page, referrer)

Use Cases

Product Feedback

• Combine survey responses with customer call insights
• Identify trends across quantitative and qualitative data
• Track feature requests from multiple sources

Customer Research

• Analyze survey responses alongside interviews
• Build comprehensive user profiles
• Generate insights from mixed data sources

Lead Qualification

• Import form responses for lead scoring
• Combine with conversation data
• Track user journey across touchpoints

Limitations

• One-Way Sync: Data flows from Typeform to BuildBetter only
• No Form Creation: Cannot create Typeform forms from BuildBetter
• Webhook Dependency: Real-time sync requires webhooks (may not work with strict firewall restrictions)

Troubleshooting

Connection Issues

• Verify the API key was generated successfully and copied in full
• Ensure your Typeform account is active and the token hasn’t been revoked
• Try regenerating the token and reconnecting

Forms Not Appearing

• Verify you have forms in your Typeform account
• Check that forms are published (not drafts)
• Refresh the form list
• Ensure the token includes forms:read scope

Responses Not Syncing

• Verify the webhook was created successfully (visible in Typeform → Form → Connect → Webhooks)
• Check that the form is still selected in BuildBetter
• Ensure your network/firewall allows webhook delivery to BuildBetter
• Test with a new form submission
• Review webhook logs in Typeform settings

Historical Import Failing

• Check for Typeform API rate limits
• Try connecting fewer forms at once for very large workspaces
• Contact support for assistance with bulk historical imports

Security & Compliance

• Encrypted token storage
• HTTPS for all data transfer
• SOC 2 compliant infrastructure
• GDPR compliant data handling
• Webhook SSL verification enabled

Support

Need help? Contact us:

• Email: [e-mail] with “Typeform Integration” in subject
• Visit our Help Center
• Schedule a setup call