# Interactive list messages | Developer Documentation

<div id="bkmrk-interactive-list-mes">## Interactive list messages

<div><span>Updated: Nov 3, 2025</span></div><div>Interactive list messages allow you to present WhatsApp users with a list of options to choose from (options are defined as rows in the request payload):</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-xbp0waxp.png)</div><div>When a user taps the button in the message, it displays a modal that lists the options available:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-fc0ztroe.png)</div><div>Users can then choose one option and their selection will be sent as a reply:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-lrj9dcac.png)</div><div>This triggers a webhook, which identifies the option selected by the user.</div><div>Interactive list messages support up to 10 sections, with up to 10 rows for all sections combined, and can include an optional header and footer.</div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>### Request parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>[System token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [business token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</div></div></td><td><div><div>```
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
```

</div></div></td></tr><tr><td><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td><div><div>v25.0</div></div></td></tr><tr><td><div><div>`<BUTTON_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Button label text. When tapped, reveals rows (options the WhatsApp user can tap). Supports a single button.</div><div>Maximum 20 characters.</div></div></td><td><div><div>`Shipping Options`</div></div></td></tr><tr><td><div><div>`<MESSAGE_BODY_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Message body text. Supports URLs.</div><div>Maximum 4096 characters.</div></div></td><td><div><div>`Which shipping option do you prefer?`</div></div></td></tr><tr><td><div><div>`<MESSAGE_FOOTER_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Message footer text.</div><div>Maximum 60 characters.</div></div></td><td><div><div>`Lucky Shrub: Your gateway to succulentsT`</div></div></td></tr><tr><td><div><div>`<MESSAGE_HEADER_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>The `header` object is optional. Supports `text` header type only.</div><div>Maximum 60 characters.</div></div></td><td><div><div>`Choose Shipping Option`</div></div></td></tr><tr><td><div><div>`<ROW_DESCRIPTION_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Row description.</div><div>Maximum 72 characters.</div></div></td><td><div><div>`Next Day to 2 Days`</div></div></td></tr><tr><td><div><div>`<ROW_ID>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>At least one row is required. Supports up to 10 rows.</div><div>Maximum 200 characters.</div></div></td><td><div><div>`priority_express`</div></div></td></tr><tr><td><div><div>`<ROW_TITLE_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Row title. At least 1 row is required. Supports up to 10 rows.</div><div>Maximum 24 characters.</div></div></td><td><div><div>`Priority Mail Express`</div></div></td></tr><tr><td><div><div>`<SECTION_TITLE_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Section title text. At least 1 section is required. Supports up to 10 sections.</div><div>Maximum 24 characters.</div></div></td><td><div><div>`I want it ASAP!`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp user phone number.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr></tbody></table>

</div></div>