Typeform

What It Does

Typeform sends form submissions in real time to DURUM.ai. Depending on the form, the submission will be classified as a lead (first contact) or application (qualification form).

Step-by-Step Configuration

1. Log in to your Typeform account
2. Open the form you want to connect
3. Click Connect in the top menu
4. Select Webhooks from the integrations list
5. Click Add a webhook
6. In the URL field, enter:
   • For a first contact form (lead):

     https://app.durum.ai/api/webhook/lead?client_key=YOUR_KEY

   • For a qualification form (application):

     https://app.durum.ai/api/webhook/application?client_key=YOUR_KEY

7. Click Save
8. Activate the webhook with the ON toggle

Hidden Fields Setup (Important for UTM Tracking)

For DURUM.ai to attribute each submission to the right ad campaign, configure hidden fields in your Typeform form:

1. In Typeform, open your form in edit mode
2. Click Logic in the sidebar
3. Select Hidden Fields
4. Add the following fields:
   • client_key -- your client identifier
   • utm_source -- traffic source (e.g., facebook, google)
   • utm_campaign -- campaign name
   • utm_content -- ad name
   • utm_term -- search term (optional)
5. In your Meta ads, add these parameters to the Typeform form URL:

   https://your-form.typeform.com/to/XXXXX#client_key=YOUR_KEY&utm_source=facebook&utm_campaign={{campaign.name}}&utm_content={{ad.name}}

WARNING

Without UTM hidden fields, DURUM.ai will receive the submission but won't be able to attribute it to a specific campaign. The lead will still be recorded, but without ad attribution.

How to Test

1. Open your Typeform form in a browser
2. Fill out a test submission (use an easily identifiable email)
3. Wait 30 seconds
4. In DURUM.ai, go to Data Logs
5. Verify the event appears with the correct type (lead or application)

Typeform Troubleshooting

Problem	Solution
Event doesn't appear	Verify the webhook is active (toggle ON) in Typeform
Status quarantined	The form isn't recognized yet. The agency will categorize it automatically.
client_key=unknown in logs	The client_key isn't present in the URL or hidden fields
No campaign attribution	Verify UTM hidden fields are configured and passed in the URL

Automatic Identification

If a Typeform form is new and the client_key isn't in the URL, DURUM.ai attempts to identify it via its known forms database. If the form is unknown, it's quarantined and the agency maps it to your account. Subsequent submissions will be automatically recognized.

---