Back to help center

Leads & integrations

Send signed lead webhooks from Onvocado

Connect a receiver and understand the lead.created event, acknowledgement and retries.

2 min read Reviewed Nov 10, 2026

01 Follow these steps

  1. Open Settings → Integrations as an owner or admin and choose the webhook connection.
  2. Enter a descriptive name and your receiver’s public HTTPS URL. Redirecting or private-network URLs are not supported.
  3. 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.
  4. 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.

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

Current connection catalogue; use the provider shown as available in your account.
Current connection catalogue; use the provider shown as available in your account.

Was this article helpful?

Related articles

Didn't find what you need?

Our team is one message away. Expect a reply within a business day.

Contact support