Using webhooks to connect your quiz to other tools
Webhooks let Convertly automatically notify any external system — your CRM, email platform, Zapier, Make, or your own server — the moment someone completes your quiz. No manual exports needed. This guide explains what webhooks are, how to set one up, and what to do with the data.
What is a webhook?
A webhook is a real-time notification sent from Convertly to a URL you specify. When a lead completes your quiz, Convertly immediately sends an HTTP POST request to that URL with the lead's data in JSON format. Think of it as an instant notification your server (or a tool like Zapier) can act on — adding the contact to a CRM, triggering an email sequence, or saving data to a spreadsheet.
Setting up your webhook URL
Open the quiz builder for the quiz you want to connect, then scroll down to the Integrations section. Paste your webhook endpoint URL into the field and click Save. The URL must start with https:// and be publicly reachable. If you don't have a server, services like Zapier, Make (Integromat), n8n, or Pipedream let you create a webhook URL in seconds — no coding required. Once saved, every new lead submission will trigger a POST request to your URL.
Understanding the payload
Every webhook request contains a JSON body with four fields: event (always "lead.completed"), timestamp (ISO 8601 date/time), quiz (id, title, slug), and lead (id, name, email, total_score, score_range_title, completed_at). Your endpoint should respond with any 2xx status code to confirm receipt. If your server returns an error status, Convertly logs the failure but does not retry automatically — so make sure your endpoint is reliable.
Common integrations
Zapier: create a "Catch Hook" trigger, paste the URL into Convertly, then add actions to create contacts in HubSpot, Mailchimp, ActiveCampaign, or a Google Sheet. Make (Integromat): use the "Custom Webhook" module as your trigger. n8n: use the Webhook node. Your own server: parse the JSON body and insert the lead into your database or trigger any business logic you need.
Fully connected!
With a webhook in place, your quiz acts as a live data source for your entire marketing stack. Every lead captured flows instantly to the right tools without any manual work.
What's next?
- Test your webhook by completing your quiz yourself and checking your endpoint received the payload
- Set up an automation in Zapier or Make to add leads directly to your CRM or email list