# user_preferences webhook reference | Developer Documentation

<div id="bkmrk-user_preferences-web">## user\_preferences webhook reference

<div><span>Updated: Nov 5, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **user\_preferences** webhook.</div><div>The **user\_preferences** webhook notifies you of changes to a WhatsApp user's [marketing message preferences](/books/meta-whatsapp/page/marketing-templates-developer-documentation).</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div>
<span>A WhatsApp user stops marketing messages.</span><span>A WhatsApp user resumes marketing messages.</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>`<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>`<PREFERENCE>`</div><div>*String*</div></div></td><td><div><div>[Marketing message preference](/books/meta-whatsapp/page/marketing-templates-developer-documentation).</div><div>Values can be:</div><div>`stop` - Indicates the WhatsApp user has opted to stop receiving marketing messages from you.</div><div>`resume` - Indicates the WhatsApp user has opted to resume receiving marketing messages from you.</div></div></td><td><div><div>`stop`</div></div></td></tr><tr><td><div><div>`<PREFERENCE_DESCRIPTION>`</div><div>*String*</div></div></td><td><div><div>Description of [marketing message preference](/books/meta-whatsapp/page/marketing-templates-developer-documentation).</div><div>Values can be:</div>
<span>`User requested to stop marketing messages`</span><span>`User requested to resume marketing messages`</span></div></td><td><div><div>`User requested to stop marketing messages`</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><tr><td><div><div>`<WHATSAPP_USER_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user ID. Note that a WhatsApp user's ID and phone number may not always match.</div></div></td><td><div><div>`16505551234`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PROFILE_NAME>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user's name as it appears in their profile in the WhatsApp client.</div></div></td><td><div><div>`Sheena Nelson`</div></div></td></tr></tbody></table>

</div></div>