# Unsupported messages webhook reference | Developer Documentation

<div id="bkmrk-unsupported-messages">## Unsupported messages webhook reference

<div><span>Updated: Mar 20, 2026</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **messages** webhook for unsupported messages.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div><span>A WhatsApp user sends a message type not supported by Cloud API.</span><span>You use the API to send a message to a number already in use with the API. In this case, the webhook is sent to the owner of the recipient number.</span><span>A WhatsApp user messages a business that has been [onboarded with a WhatsApp Business app phone number](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation), for the first time. This is especially common when users tap one of the business's [ads that click to WhatsApp<span>?</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fproducts%2Fcreate-ads-that-click-to-whatsapp&h=AT5AkQiBQbUaDrxD4J9vQgtwxb9J01kFBJBPnMhqHDCBjAxfsxVYAWGPPN_q7rkTHbyinHafiVTTbDxB4kePCtbuU0svLjYiYK_KNj_F33W0KSmQEmLUgvOf5YoNxyF_ON4BgKGI-7Pr1gwx1t4YBw) and immediately send a message.</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>`<IDENTITY_KEY_HASH>`</div><div>*String*</div></div></td><td><div><div>Identity key hash. Only included if you have enabled the [identity change check](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation) feature.</div></div></td><td><div><div>`DF2lS5v2W6x=`</div></div></td></tr><tr><td><div><div>`<ERROR_CODE>`</div></div></td><td><div><div>The error code. Possible values:</div><span>`131051` - Cloud API does not support the message type.</span><span>`131060` - The message is currently unavailable. This typically occurs when a WhatsApp user messages a business [onboarded with a WhatsApp Business app phone number](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation), for the first time.</span></div></td><td><div><div>`131051`</div></div></td></tr><tr><td><div><div>`<ERROR_DETAILS>`</div></div></td><td><div><div>A human-readable description of the error.</div></div></td><td><div><div>`Message type is currently not supported.`</div></div></td></tr><tr><td><div><div>`<ERROR_MESSAGE>`</div></div></td><td><div><div>A human-readable error message. Same as `ERROR_TITLE`.</div></div></td><td><div><div>`Message type unknown`</div></div></td></tr><tr><td><div><div>`<ERROR_TITLE>`</div></div></td><td><div><div>A human-readable error title. Possible values:</div><span>`Message type unknown` - Corresponds to error code `131051`.</span><span>`This message is currently unavailable.` - Corresponds to error code `131060`.</span></div></td><td><div><div>`Message type unknown`</div></div></td></tr><tr><td><div><div>`<UNSUPPORTED_TYPE>`</div></div></td><td><div><div>Contains the type of message that is unsupported.</div><div>Values can be:</div><div>`errors`</div><div>`gif`</div><div>`group_invite`</div><div>`hsm`</div><div>`image`</div><div>`interactive`</div><div>`keep_in_chat`</div><div>`link_preview`</div><div>`list`</div><div>`location`</div><div>`media_placeholder`</div><div>`order`</div><div>`pin`</div><div>`poll_creation`</div><div>`poll_update`</div><div>`product`</div><div>`reaction`</div></div></td><td><div><div>`poll_update`</div></div></td></tr><tr><td><div><div>`<WEBHOOK_TRIGGER_TIMESTAMP>`</div><div>*String*</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_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_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_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user phone number. This is the same value returned by the API as the `input` value when sending a message to a WhatsApp user. Note that a WhatsApp user's phone number and ID 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>