Connect TypeForm to Groundhogg
This guide will walk you through the process of integrating TypeForm with Groundhogg by setting up a webhook in TypeForm to send form submission data to Groundhogg's Webhook Listener. This allows you to automatically capture form data as contacts in Groundhogg for marketing automation and CRM purposes.
Prerequisites
- A TypeForm account with a form created.
- A WordPress site with Groundhogg installed and the Advanced Features add-on activated.
- Administrative access to both Formsite and your WordPress site.
Step 1: Create a Form in Typeform
- Log in to Typeform:
- Go to your Typeform dashboard and sign in.
- Create or Select a Form:
- Either create a new form or choose an existing one to connect to Groundhogg.
- Add fields you want to capture (e.g., First Name, Email, Phone) and save your form.
Step 2: Set Up the Webhook Listener in Groundhogg
- Log in to Your WordPress Admin Dashboard:
- Navigate to your WordPress site where Groundhogg is installed.
- Access Groundhogg Funnels:
- In the WordPress admin menu, go to Groundhogg > Funnels.
- Create a New Funnel:
- Click Add New Funnel.
- Select Start from Scratch and name your funnel (e.g., "Typeform Integration").
- Click Create.
- Add the Webhook Listener Benchmark:
- In the funnel editor, click the + icon to add a step.
- Under the Benchmarks tab, select Webhook Listener.
- Add it as the starting step of your funnel.
- Copy the Webhook URL:
- In the Webhook Listener configuration panel, find the Webhook URL (e.g., https://yourdomain.com/wp-json/gh/v3/hooks/your-secret-key).
- Copy this URL to your clipboard—this is where Typeform will send data.
- Activate the Funnel:
- Ensure the funnel is set to Active using the toggle in the top-right corner. (Field mapping will be configured later after testing.)
Step 3: Configure the Webhook in Typeform
- Go to Typeform Connect Panel:
- In your Typeform dashboard, select the form you want to integrate.
- Click Connect in the top menu, on the left click Webhooks.
- Add a New Webhook:
- Click Add a Webhook.
- Paste the Groundhogg Webhook URL into the Endpoint URL field.
- Enable the Webhook:
- Toggle the webhook to On.
- Optionally, add a Secret for security (Groundhogg doesn’t require this, but it’s a good practice).
- Save the Webhook:
- Click Save to activate the webhook. Typeform will now send form submissions to Groundhogg.
Step 4: Test the Connection
- Submit a Test Form:
- Open your Typeform (find the live link under Share in the Typeform dashboard).
- Fill out the form with sample data (e.g., name, email) and submit it.
- Check Groundhogg for Incoming Data:
- Return to your Groundhogg funnel editor in WordPress.
- Edit the Webhook Listener step.
- In the Request section, verify that the data from your Typeform submission appears (e.g., {"email": "test@example.com", "first_name": "Test"}).
- If no data shows, ensure the funnel is active and the Webhook URL matches exactly.
Step 5: Map Typeform Fields to Groundhogg Contact Fields
- Configure Field Mapping in Groundhogg:
- In the Webhook Listener configuration panel, click Map Request Fields.
- Match Typeform field references (from the Request data) to Groundhogg contact fields:
- Example: Map email to Email, first_name to First Name.
- If a field isn’t available in Groundhogg, create a custom field first.
- Save the mapping by clicking Update.
- Add Additional Actions (Optional):
- In the funnel, add steps after the Webhook Listener, such as:
- Apply Tag: To tag the contact (e.g., "Typeform Lead").
- Add Note: To add a note to the contact (e.g., "This Contact came from TypeForm on {date.l jS F Y h:i:s A|now}").
- Update the funnel after adding steps.
- In the funnel, add steps after the Webhook Listener, such as:
Step 6: Verify the Integration
- Submit Another Test Form:
- Fill out and submit the Typeform again with new test data.
- Check Groundhogg Contacts:
- Go to Groundhogg > Contacts in your WordPress dashboard.
- Confirm a new contact appears with the data from your test submission (e.g., name, email).
- Verify mapped fields and any additional actions (like tags) were applied correctly.
- Troubleshoot if Needed:
- If no contact appears, ensure the funnel is active, field mappings are correct, and the Webhook URL hasn’t changed.
You’ve now connected Typeform to Groundhogg using webhooks! Form submissions will automatically flow into Groundhogg, enabling you to manage contacts and automate marketing workflows. For further customization, explore Groundhogg’s funnel builder to add actions like sending emails or triggering campaigns.