Typeform Integration (Alpha)

Documentation Index

Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt

Use this file to discover all available pages before exploring further.

Connect BuildBetter with Typeform to import your forms and responses, enabling you to analyze survey feedback alongside customer conversations and calls.

​

Overview

The Typeform integration enables you to:

• Import Typeform forms as surveys
• Sync responses in real-time via webhooks
• Connect response data to BuildBetter’s analytics
• Analyze survey feedback with conversation data
• Extract signals from form submissions

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

​

Features

• OAuth 2.0 Authentication: Secure connection to your Typeform account
• 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
• Question Type Support: All Typeform question types supported
• Response Tracking: Track submissions with timestamps and metadata
• Per-Form Control: Select which forms to sync

​

Setup Guide

​

Prerequisites

1. Typeform Requirements:
   • Active Typeform account
   • Forms with responses (or ready to receive responses)
   • Admin access for OAuth authorization
2. BuildBetter Requirements:
   • Active BuildBetter account
   • Admin privileges for integration setup

​

Quick Setup

1. Initiate Connection
   • Go to Settings > Integrations in BuildBetter
   • Select “Typeform”
   • Click “Connect to Typeform”
2. Authorize OAuth
   • You’ll be redirected to Typeform
   • Log in to your Typeform account
   • Review and approve the requested permissions:
     • Read your forms
     • Read form responses
     • Create webhooks for real-time updates
   • Click “Authorize”
3. Select Forms
   • After authorization, you’ll see a list of your Typeform forms
   • Select which forms you want to sync
   • Click “Connect Form” for each form you want to import
4. Webhook Setup
   • BuildBetter automatically creates webhooks for selected forms
   • Responses will be synced in real-time as they’re submitted
   • Historical responses can be imported on-demand

​

Supported Question Types

All Typeform question types are supported:

​

How It Works

​

Initial Setup Flow

1. User authorizes BuildBetter to access Typeform account
2. OAuth tokens are securely stored
3. User selects which forms to sync
4. Webhooks are created for each selected form
5. Historical responses can optionally be imported

​

Real-Time Sync

1. User submits a Typeform response
2. Typeform fires webhook to BuildBetter
3. Response is processed and stored
4. Data becomes available for analysis 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.)

​

OAuth Permissions

The integration requests the following scopes:

• accounts:read - Read your Typeform account information
• forms:read - Read your forms and their structure
• forms:write - Create webhooks for your forms
• responses:read - Read form responses
• webhooks:read - View existing webhooks
• webhooks:write - Create and manage webhooks
• offline - Maintain access with refresh tokens

​

Configuration Options

​

Per-User Integration

• Each BuildBetter user connects their own Typeform account
• Forms are synced under the connecting user’s context
• Multiple users can connect different Typeform accounts

​

Per-Form Control

• Select which forms to sync individually
• Enable/disable forms without disconnecting integration
• Historical import is optional per 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

​

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
• User-Scoped: Integration is per-user, not organization-wide
• Webhook Dependency: Real-time sync requires webhooks (may not work with firewall restrictions)
• Token Expiration: OAuth tokens need periodic refresh (handled automatically)

​

Troubleshooting

​

Connection Issues

• Verify OAuth authorization completed successfully
• Check that you approved all requested permissions
• Ensure your Typeform account is active
• Try disconnecting 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 proper OAuth scopes were granted

​

Responses Not Syncing

• Verify webhook was created successfully
• Check that form is still connected
• Ensure network/firewall allows webhook delivery
• Test with a new form submission
• Review webhook logs in Typeform settings

​

Historical Import Failing

• Verify sufficient storage space in BuildBetter
• Check for API rate limits
• Try smaller date ranges for large forms
• Contact support for bulk imports

​

Security & Compliance

• OAuth 2.0 secure authentication
• 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: support@buildbetter.app with “Typeform Integration” in subject
• Visit our Help Center
• Schedule a setup call