Typeform and Twilio integrate through Typeform's native webhook delivery and the Twilio Messages API to trigger SMS the moment a Typeform is submitted, enabling instant respondent confirmation and team lead alerts that arrive faster than email and are far more likely to be read immediately. This integration is used by sales teams using Typeform for lead capture, HR teams running candidate screening forms, and event organizers collecting RSVP data who want to engage respondents by SMS within seconds of form completion. Typeform's webhook system sends a rich JSON payload containing all question answers, respondent metadata, and form details to your middleware endpoint, giving you everything needed to personalize and dispatch targeted SMS.
What You Need Before You Start
Configure a Typeform webhook by opening your form in the Typeform workspace, navigating to Connect, then Webhooks, clicking Add a Webhook, entering your middleware endpoint URL, and optionally enabling the Secret Token field with a shared secret that Typeform will include in a Typeform-Signature header for payload verification. Add a Phone Number question to your Typeform by inserting a Phone Number question type from the question palette in the Typeform editor, marking it as Required so all respondents provide a phone, and note the question reference ID visible in the question settings which takes the format of a string like phone_number_abc123 that you will use to extract the value from the webhook payload. From Twilio, collect your Account SID, Auth Token, and an SMS-capable phone number, and register under A2P 10DLC in the Twilio Console for US-bound messaging. Confirm your middleware server has a public HTTPS endpoint, as Typeform requires HTTPS for webhook delivery and does not deliver to plain HTTP endpoints.
Step-by-Step Integration Guide
In your middleware webhook handler, verify the Typeform signature by computing HMAC-SHA256 of the raw request body using the shared secret as the key and comparing the Base64-encoded result against the value in the Typeform-Signature header after removing the sha256= prefix, returning HTTP 400 for failed verification. Parse the verified JSON payload to extract the respondent's phone number from the form_response.answers array by finding the element where the field.ref matches your phone question's reference ID and reading the phone_number property on that answer object. Normalize the extracted phone to E.164 format and dispatch a Twilio SMS confirmation by calling POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json with Basic authentication, To set to the normalized phone, From set to your Twilio number, and Body composed with the respondent's name extracted from the form_response.answers array's text answer for the name field, personalizing the confirmation message. Send a parallel team alert SMS by making a second Twilio API call with To set to your internal team phone, From set to your Twilio number, and Body containing a summary of the key form fields such as respondent name, phone, email, and their answer to a qualifying question, enabling immediate sales rep follow-up while the lead is still actively engaged.
Common Issues and How to Fix Them
Typeform webhook payloads reference questions by the field.ref identifier rather than a human-readable label, and if your Typeform was built without explicitly setting ref values the system generates random alphanumeric ref strings that change if questions are deleted and re-added. Set a custom stable ref value for your phone question in the Typeform editor under Question Settings, then Reference, using a consistent name like respondent_phone, and update your middleware to reference that stable value instead of position-based indexing. Typeform delivers webhooks with a 10-second timeout expectation and retries delivery up to 3 times if your middleware does not return HTTP 200 within that window, which can cause duplicate SMS if your Twilio dispatch takes more than 10 seconds during peak load. Return HTTP 200 to Typeform immediately upon receiving the webhook and dispatch the Twilio SMS asynchronously in a background job to decouple webhook acknowledgment from SMS delivery time. Typeform's Phone Number question type validates phone format client-side but allows submission in local format without a country code when the respondent uses a mobile browser with autofill, producing phone values like 5558675309 without a country code prefix. Detect the missing country code by checking whether the normalized phone is less than 11 digits for a US number and prepend the +1 prefix, or use a country detection library with the respondent's IP country from the form_response.metadata.browser field as the default region hint.
How to Get More from This Integration
Build a Typeform quiz result SMS by reading the respondent's score from the form_response.calculated.score field in the webhook payload and including it in the Twilio SMS body with a personalized message based on the score range, enabling instant quiz score delivery via text that respondents read immediately rather than waiting to check email. Create a conditional team routing SMS by reading a qualifying question answer from the payload such as budget range or company size and dispatching the internal lead alert to different team member phone numbers based on the answer value, ensuring high-value leads reach senior sales staff immediately. Add a follow-up SMS sequence by storing the respondent's phone, submission ID, and timestamp in your database from the webhook handler, then running a scheduled job 24 hours later that dispatches a Twilio follow-up SMS to respondents who have not yet converted, checking your CRM or database for conversion status before sending. Extend the integration to Typeform Logic Jumps by reading the ending.ref field in the webhook payload to determine which Typeform thank-you screen the respondent reached, and mapping each ending ref to a different Twilio SMS message that matches the content of that specific thank-you screen, delivering a consistent cross-channel message.
Conclusion
Typeform and Twilio together create an instant SMS response system for every form submission, turning form completions into real-time conversations before the respondent closes the browser tab. Reach out to Telphi Consulting to build and configure a Typeform Twilio integration for your lead capture and survey workflows.
Ready to Transform Your Business Communications?
Get a free consultation with our VoIP experts and discover how we can help you save costs, improve efficiency, and scale your business.
Comments (0)
Join the discussion and share your thoughts (AI-moderated for quality)
Be the first to comment
No comments yet. Share your thoughts below.