- Open Settings → Integrations as an owner or admin and choose the webhook connection.
- Enter a descriptive name and your receiver’s public HTTPS URL. Redirecting or private-network URLs are not supported.
- Save the connection, then open Send leads to for the intended popup. Select the connection and the fields to deliver, then enable automatic sending if required.
- Connecting an account does not send a test contact. Submit marked test data through the installed popup and inspect both the receiver and the lead’s delivery details.
Leads & integrations
Send signed lead webhooks from Onvocado
Connect a receiver and understand the lead.created event, acknowledgement and retries.
01 Follow these steps
02 The event your receiver gets
A completed form submission produces a lead.created event. Answers are inside fields; they are not top-level first_name/email keys. Typing into a field alone does not send this event. Each completed form is handled independently.
03 Example payload
{
"id": "SUBMISSION-UUID",
"type": "lead.created",
"created_at": "2026-11-10T10:00:00+00:00",
"campaign": {"id": "CAMPAIGN-UUID", "name": "Welcome signup"},
"website": {"hostname": "example.com"},
"form_id": "signup",
"fields": {"email": "test@example.com", "consent": true}
}This is an illustrative payload. The form ID and answer keys come from the actual published form.
04 Verify and acknowledge delivery
Custom receivers can verify X-Onvocado-Signature using the connection’s signing secret from Copy signing secret. The signed input is the timestamp, a dot and the raw request body, using HMAC-SHA256. Check X-Onvocado-Timestamp for freshness. Deduplicate the submission UUID in X-Onvocado-Event-ID or Idempotency-Key: retries keep the event ID but use a fresh timestamp and signature. Return success only after accepting the event. Completed means receiver acknowledgement, not a downstream email or workflow completion.
05 If something is different
Use lead delivery details to distinguish a saved lead from a failed destination. Fix URL or mapping errors before retrying. For automation platforms, follow the Zapier Catch Hook or Make webhook guide.
06 What the current app looks like
Was this article helpful?
Related articles
Find your leads and troubleshoot delivery
Separate form capture, external sync and subscription confirmation.
Read article
Send new Onvocado leads to Zapier
Use Webhooks by Zapier with completed form submissions.
Read article
Send Onvocado leads to Make
Connect a custom webhook and map the actual submitted fields.
Read article
Didn't find what you need?
Our team is one message away. Expect a reply within a business day.
Contact support