Typeform Setup

Each form integrated with our system should be treated as a standalone entry with its own configuration. Follow the steps below based on how you're creating the form:

πŸ”§ New Form Setup

If you're starting from scratch:

  1. Add Hidden Fields
    • Go to the Workflow tab at the top of the page.
    • Scroll to the far left and click on the "Pull data in" card.
    • From there, enable any default fields and add any required custom ones.
    Minimum required fields:
    • user_id (under Respondent Information)
    • webinar_id (Custom)
    • lead_id (Custom)
    • page_url (Custom)
    • is_replay (Custom)
  2. Add a Webhook
    • Click on the Connect tab at the top.
    • Select the Webhooks tab next to "Integrations".
    • Click Add a webhook and enter the following URL:
      https://prd-xms-api.combinedcuriosity.io/api/typeform-webhook/
    • Click Save changes
    • Edit the newly created webhook
    • Add the secret from 1Pass named Typeform Webhook Secret
    • IF the form is set up for partial responses update the triggers to include Partial responese
    • Click Save Changes
    • Click the Webhook off toggle to activate the webhook

If you're duplicating an existing form:
βœ… Only the webhook step is needed β€” hidden fields will carry over automatically.

πŸ’‘ Tips & Tricks

πŸ”„ Partial Responses

  • Typeform auto-advances after each question, except when the next step requires a submit button or explicit interaction.
  • A partial response counts as an explicit interaction.
  • Users who start but don’t cross one of these explicit interatction points won’t trigger a webhook β€” consider this in any automated workflows or lead follow-up logic.

πŸ“š More Resources

‍