Unsupported messages webhook reference | Developer Documentation

Unsupported messages webhook reference

Updated: Mar 20, 2026

This reference describes trigger events and payload contents for the WhatsApp Business Account messages webhook for unsupported messages.

Triggers

A WhatsApp user sends a message type not supported by Cloud API.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.A WhatsApp user messages a business that has been onboarded with a WhatsApp Business app phone number, for the first time. This is especially common when users tap one of the business's ads that click to WhatsApp? and immediately send a message.

Parameters

Placeholder	Description	Example value
`<BUSINESS_DISPLAY_PHONE_NUMBER>` String	Business display phone number.	`15550783881`
`<BUSINESS_PHONE_NUMBER_ID>` String	Business phone number ID.	`106540352242922`
`<IDENTITY_KEY_HASH>` String	Identity key hash. Only included if you have enabled the identity change check feature.	`DF2lS5v2W6x=`
`<ERROR_CODE>`	The error code. Possible values: `131051` - Cloud API does not support the message type.`131060` - The message is currently unavailable. This typically occurs when a WhatsApp user messages a business onboarded with a WhatsApp Business app phone number, for the first time.	`131051`
`<ERROR_DETAILS>`	A human-readable description of the error.	`Message type is currently not supported.`
`<ERROR_MESSAGE>`	A human-readable error message. Same as `ERROR_TITLE`.	`Message type unknown`
`<ERROR_TITLE>`	A human-readable error title. Possible values: `Message type unknown` - Corresponds to error code `131051`.`This message is currently unavailable.` - Corresponds to error code `131060`.	`Message type unknown`
`<UNSUPPORTED_TYPE>`	Contains the type of message that is unsupported. Values can be: `errors` `gif` `group_invite` `hsm` `image` `interactive` `keep_in_chat` `link_preview` `list` `location` `media_placeholder` `order` `pin` `poll_creation` `poll_update` `product` `reaction`	`poll_update`
`<WEBHOOK_TRIGGER_TIMESTAMP>` String	Unix timestamp indicating when the webhook was triggered.	`1739321024`
`<WHATSAPP_BUSINESS_ACCOUNT_ID>` String	WhatsApp Business Account ID.	`102290129340398`
`<WHATSAPP_MESSAGE_ID>` String	WhatsApp message ID.	`wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`
`<WHATSAPP_USER_ID>` String	WhatsApp user ID. Note that a WhatsApp user's ID and phone number may not always match.	`16505551234`
`<WHATSAPP_USER_PHONE_NUMBER>` String	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.	`+16505551234`
`<WHATSAPP_USER_PROFILE_NAME>` String	WhatsApp user's name as it appears in their profile in the WhatsApp client.	`Sheena Nelson`