4 min readUpdated Oct 7, 2026webhooks, events, payload
Webhook Events
The 41 LeadPattern webhook events (messages, conversations, contacts, notes, flows, calls and WooCommerce) and the envelope every delivery uses.
When you create or edit a webhook, the Select Triggers step lists the events it can receive,
grouped below. The event name in code is the value of event in the payload and of the
X-Webhook-Event header.
The delivery envelope
Every delivery is a JSON POST with the same four fields:
JSON16 lines
1{
2 "id": "3f1c2a9e-7b4d-4c1e-9a52-0d6c8e7f1b20",
3 "event": "message_received",
4 "timestamp": "2026-07-01T10:30:00.000Z",
5 "data": {
6 "contact": {
7 "waId": "15550100123",
8 "profileName": "Jordan"
9 },
10 "message": {
11 "messageId": "wamid.HBgM...",
12 "direction": "incoming",
13 "type": "text"
14 }
15 }
16}
id: unique per event and identical across retries (also sent asX-Webhook-Id). Use it to skip duplicates.event: the event name.timestamp: when the event happened (ISO 8601, UTC).data: the event details. Its shape depends on the event. The developer API docs include a full example for every event.
Events
| Event | Label |
|---|---|
message_received | Message Received |
message_status_update | Message Status Update |
first_message | First Message |
template_updated | Template Updated |
raw_whatsapp | Raw WhatsApp Payload |
Test events
Send test delivers a sample payload whose event is test. Make sure your server answers it
with a 2xx status, even though it isn't one of the events above.
What's next
Was this article helpful?
Your feedback helps us continuously improve our documentation.
Need more help with this topic?Ask LeadPattern Support
Related Articles
Webhooks & API
Webhooks Overview
LeadPattern webhooks send real-time events, such as new messages, chat assignments and calls, to your own server as signed HTTPS POST requests.
Read article
Webhooks & API
Create a Webhook
Register a webhook endpoint in LeadPattern, choose the events it receives, sign deliveries with a secret, and send a test before saving.
Read article
Webhooks & API
Verify Webhook Signatures
Why you should sign LeadPattern webhook deliveries, how to turn signing on, and how to verify the HMAC-SHA256 X-Webhook-Signature headers, with Node.js and Python examples that handle secret rotation.
Read article
Webhooks & API
Manage Webhooks
Edit LeadPattern webhooks, rotate or replace signing secrets with a 24-hour grace period, pause and resume deliveries, and understand each status badge.
Read article