---
schema_version: "1"
id: 825341fa68589cb1dfa46875cfe3302fdd366ef38049be90d2edcb9ed81c5e93
title: Create WhatsApp List Messages
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mc_jb_whatsapp_lists.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mc_jb_whatsapp_lists.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f35277130a76b6c6931b299422262bbf8e61ed7691a08962e7865e35d5bb84e7
description: Give your customers a list of options during a conversation by using WhatsApp list messages in Marketing Cloud Engagement journeys. For example, if a customer sends you a message asking to reorder a product that they've previously purchased, your response can include a list of their most recent purchases.
products:
  - Marketing
  - Marketing Cloud Engagement
release: "264"
---
# Create WhatsApp List Messages

Give your customers a list of options during a conversation by using WhatsApp list messages in Marketing Cloud Engagement journeys. For example, if a customer sends you a message asking to reorder a product that they've previously purchased, your response can include a list of their most recent purchases.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col>
          <col>
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d11193e38">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d11193e38 ">To create messages:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11193e38 ">Marketing Cloud Administrator, Marketing Cloud Channel Manager, or Marketing Cloud
              Content Editor/Publisher</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d11193e38 ">To manage journeys:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11193e38 ">Marketing Cloud Administrator, Marketing Cloud Channel Manager, or Marketing Cloud
              Content Editor/Publisher</td>

          </tr>
        </tbody>
      </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-mc_journeys_and_automations-264-0-0-production-enus/e08cdd71-c1c1-4ae5-a5e9-8a6dad583ad4/images/icon_note.png)

Note List messages are supported only in accounts with Unified Messaging. For more information, contact your Account Executive.

1. In Content Builder, select **Create** | **Chat Messaging** | **WhatsApp Session Message**.
2. For Message Type, select **List**.
3. Configure the header, body, and footer for the session message.
4. Under List Button, for **Button Text**, enter the text that appears on the button that customers click to view the list.
5. Under Sections, specify an optional section title and description.
    
    The title and description appear above the list entries for the section.
6. For **Button Label**, enter the text that appears on the button that customers click to begin the flow.
7. Configure the items that you want to appear in the list. For each list item, configure these components.
    1. For **Row Title**, enter the title of the list item.
    2. If you want to include additional text below the title of the list item, enter the text in the **Row Description** field.
    3. For **Pass Back Value**, enter a unique value.
        
        The value that you specify in this field isn't visible to customers. When your customer selects an item from a list, the pass back value is sent to Event Notification Service (ENS). You can use this value in decision points in the current journey or to trigger other journeys.
8. To add another section, click **Add Section**, and then configure the list items for that section.
    
    Sections are helpful for organizing list items. You can create up to 10 sections. The total number of list items across all sections can't be greater than 100.
9. Save your changes.

After you create a session message, [add it to a journey](https://help.salesforce.com/s/articleView?id=mktg.mc_jb_whatsapp_send_session_messages_in_journey_builder.htm&release=264.0.0&type=5 "After you personalize your session messages, use Journey Builder to start sending.").

Events generated by list messages are returned to Journey Builder as events. You can also retrieve details about these events in [data extracts](https://help.salesforce.com/s/articleView?id=mktg.mc_jb_whatsapp_data_extract.htm&language=en_US), [Event Notification Service events](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/ens-get-started.html), or [Data 360 extracts](https://developer.salesforce.com/docs/data/data-cloud-ref/guide/c360a-api-extract-data.html).

#### See Also

- [_Marketing Cloud Engagement APIs and Programmatic Languages_: WhatsApp List Payload Example](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/engagement_ott_events_mobile_originated.html#lists)