# security webhook reference | Developer Documentation

<div id="bkmrk-security-webhook-ref">## security webhook reference

<div><span>Updated: Oct 22, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **security** webhook.</div><div>The **security** webhook notifies you of changes to a business phone number's security settings.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div>
<span>A Meta Business Suite user clicks the **Turn off two-step verification** button in [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/).</span><span>A Meta Business Suite user completes the instructions in the **WhatsApp Two-Step Verification Reset** email to turn off two-step verification.</span><span>A Meta Business Suite user changes or enables the business phone number PIN using [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/).</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>`<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>`<EVENT>`</div><div>String</div></div></td><td><div><div>The security event that triggered the webhook.</div><div>Values can be:</div><div>`PIN_CHANGED` - indicates a Meta Business Suite user changed or enabled the business phone number's PIN using [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/).</div><div>`PIN_RESET_REQUEST` - Indicates a Meta Business Suite user clicked the Turn off two-step verification button in [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/).</div><div>`PIN_REQUEST_SUCCESS` - a Meta Business Suite user completed the instructions in the WhatsApp Two-Step Verification Reset email to turn off two-step verification.</div></div></td><td><div><div>`PIN_RESET_REQUEST`</div></div></td></tr><tr><td><div><div>`<META_BUSINESS_SUITE_USER_ID>`</div><div>String</div></div></td><td><div><div>The Meta Business Suite user ID of the user who requested to turn off two-step verification using [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/).</div><div>This parameter is only included for PIN reset requests.</div></div></td><td><div><div>`61555822107539`</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_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>