Funnel Draw / Integrations / Webhooks
Funnel Draw + Webhooks
Funnel Draw posts a signed JSON event to your URL when a funnel is created, updated or deleted, or when a checklist task is done. Use it to keep another system in step without polling.
Developers · Webhooks
How it works
- Four events that matter funnel.created, funnel.updated (at most one per funnel every 5 minutes), funnel.deleted and task.completed.
- Signed, so you can trust it Each delivery carries FunnelDraw-Signature: t=…,v1=…, an HMAC-SHA256 of the timestamp and body with your secret.
- Retries you can see Failed deliveries retry at 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours, and every attempt is listed with its status code.
Set it up
Add your endpoint
In Funnel Draw, open your workspace → Integrations → Webhooks → Add. Paste an https URL and tick the events you want.
Keep the secret
The signing secret is shown once when you add the webhook. Store it where your endpoint can read it.
Verify each delivery
Compute HMAC-SHA256 of "<t>.<raw body>" with the secret and compare it with v1 in the FunnelDraw-Signature header. Reject old timestamps.
Send a test
Press Send test to get a ping event now, then check the deliveries list for its status and response code.
Ideas to try
When a task is done, close the ticket
Your endpoint receives task.completed with the task's text and the funnel, and closes the matching ticket in your tracker.
When a funnel changes, refresh the report
funnel.updated tells your reporting job to pull the new forecast through the API and rebuild the client's dashboard.
Questions
What does a delivery look like?
JSON: {id, event, created, workspaceId, data: {funnel: {id, name, url}, task}}, sent with User-Agent FunnelDraw-Webhooks/1.
What happens if my endpoint is down?
It retries five times over about nine hours. After 20 failures in a row the webhook switches itself off, and the Integrations page says so.
How many webhooks can I add?
Up to 10 per workspace.
More in Developers
Draw it yourself,
or hand it to your AI.
3 days free, no card.