# automatic_events webhook reference | Developer Documentation

<div id="bkmrk-automatic_events-web">## automatic\_events webhook reference

<div><span>Updated: Nov 5, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account `automatic_events` webhook.</div><div>The **automatic\_events** webhook notifies you when we detect a purchase or lead event in a chat thread between you and a WhatsApp user who has messaged you via your Click to WhatsApp ad, if you have opted-in to [Automatic Events](/books/meta-whatsapp/page/automatic-events-api-developer-documentation) reporting.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div><span>A lead event is detected in a chat thread between a business and user who has messaged the business via a Click to WhatsApp Ad.</span><span>A purchase event is detected in a chat thread between a business and user who has messaged the business via a Click to WhatsApp Ad.</span><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>### Parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example value </span></th></tr></thead><tbody><tr><td><div><div>`<AD_CLICK_ID>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad click ID.</div><div>The `ctwa_clid` property is omitted entirely for messages originating from an ad in WhatsApp Status ([WhatsApp Status ad placements<span>?</span>](https://www.facebook.com/business/help/1074444721456755)).</div></div></td><td><div><div>```
Aff-n8ZTODiE79d22KtAwQKj9e_mIEOOj27vDVwFjN80dp4_0NiNhEgpGo0AHemvuSoifXaytfTzcchptiErTKCqTrJ5nW1h7IHYeYymGb5K5J5iTROpBhWAGaIAeUzHL50
```

</div></div></td></tr><tr><td><div><div>`<AMOUNT>`</div><div>*String*</div></div></td><td><div><div>Purchase amount, calculated as product price multiplied by 1000.</div></div></td><td><div><div>`25000`</div></div></td></tr><tr><td><div><div>`<BUSINESS_DISPLAY_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>Business display phone number.</div></div></td><td><div><div>`15550783881`</div></div></td></tr><tr><td><div><div>`<BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>Business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<CURRENCY_CODE>`</div><div>*String*</div></div></td><td><div><div>Currency code.</div></div></td><td><div><div>`USD`</div></div></td></tr><tr><td><div><div>`<EVENT_NAME>`</div><div>*String*</div></div></td><td><div><div>Event name. Values can be:</div><span>`LeadSubmitted` - Indicates a lead event.</span><span>`Purchase` - Indicates a purchase event.</span></div></td><td><div><div>`Purchase`</div></div></td></tr><tr><td><div><div>`<WEBHOOK_TRIGGER_TIMESTAMP>`</div><div>*Integer*</div></div></td><td><div><div>Unix timestamp indicating when the webhook was triggered.</div></div></td><td><div><div>`1739321024`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_MESSAGE_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp message ID.</div></div></td><td><div><div>`wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_ACCOUNT_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp Business Account ID.</div></div></td><td><div><div>`102290129340398`</div></div></td></tr></tbody></table>

</div></div>