# List

{% hint style="info" %}
All examples below must be sent within the **body** field of a message as shown below
{% endhint %}

{% code lineNumbers="true" %}

```json
{
 "receiver": {
   "contacts": [
     {
       "identifierValue": "+31612345678"
     }
   ]
 },
 "body": {...}
}
```

{% endcode %}

## List message without sections

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "list",
  "list": {
    "items": [
      {
        "actions": [
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-1",
              "text": "Postback action 1"
            }
          },
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-2",
              "text": "Postback action 2"
            }
          }
        ]
      }
    ],
    "title": "List title",
    "altText": "List alt text",
    "text": "List text"
  }
}
```

{% endcode %}

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FGtfL2fiKTMydz83NFUjL%2Fimage.png?alt=media\&token=ad37e9c6-45a5-46c0-8b02-d0b089e6c77f)

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F7yw2T8sOtiZH8JwJy71g%2Fimage.png?alt=media\&token=b93b27d6-c34e-440b-a360-f57397eac47f)

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FR8Kb1EB7hf6cfp2sxHDV%2Fimage.png?alt=media\&token=504246ae-665e-4177-a688-a7cb254a073f)

#### Instagram

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FCDGmxMgLQHrALm1PmjDi%2Fimage.png?alt=media\&token=2a3a3448-1dc2-4127-b560-40de55612ea3)

#### Line

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FJQYjDO2EnPEKDEqrmDKV%2Flist%20message%20without%20sections.png?alt=media&#x26;token=9859d3f3-47a8-4886-95b9-e685084ec7fa" alt=""><figcaption></figcaption></figure></div>

## List message with sections

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "list",
  "list": {
    "items": [
      {
      "title": "Section 1",
        "actions": [
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-1",
              "text": "Postback action 1"
            }
          },
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-2",
              "text": "Postback action 2"
            }
          }
        ]
      },
      {
        "title": "Section 2",
        "actions": [
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-3",
              "text": "Postback action 3"
            }
          },
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-4",
              "text": "Postback action 4"
            }
          }
        ]
      }
    ],
    "title": "List title",
    "altText": "List alt text",
    "text": "List text"
  }
}
```

{% endcode %}

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2Fbnvp07OoVTIk8JAW5eYI%2Fimage.png?alt=media\&token=92be4252-6f3f-4fb5-880a-70bc1657f2cf)

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FFOWioO5qAt50XxfNpzrO%2Fimage.png?alt=media\&token=65a4eb2b-a95a-4548-8c32-305e83315427)

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FEwhpwBbMxTQmIQyWmRlt%2Fimage.png?alt=media\&token=d472844b-7da7-4015-b0c4-605f6279e1d6)

#### Instagram&#x20;

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F4ks1bD7xpmIvKKngllZ0%2Fimage.png?alt=media\&token=e699803a-0f6c-4429-afd2-8995c0feac91)

## List message with metadata

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "list",
  "list": {
    "items": [
      {
        "title": "Section 1",
        "actions": [
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-1",
              "text": "Postback action 1",
              "metadata": {
                "description": {
                  "label": "Postback action description 1"
                }
              }
            }
          },
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-2",
              "text": "Postback action 2",
              "metadata": {
                "description": {
                  "label": "Postback action description 2"
                }
              }
            }
          }
        ]
      },
      {
        "title": "Section 2",
        "actions": [
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-3",
              "text": "Postback action 3",
              "metadata": {
                "description": {
                  "label": "Postback action description 3"
                }
              }
            }
          },
          {
            "type": "postback",
            "postback": {
              "payload": "postback-action-payload-4",
              "text": "Postback action 4",
              "metadata": {
                "description": {
                  "label": "Postback action description 4"
                }
              }
            }
          }
        ]
      }
    ],
    "title": "List title",
    "altText": "List alt text",
    "text": "List text",
    "metadata": {
      "button": {
        "label": "Show options"
      }
    }
  }
}
```

{% endcode %}

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FngFhglO9ACG0a0Bpq6pU%2Fimage.png?alt=media\&token=56b251a4-0335-4e96-94d2-95616c2a5b97)

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FIPtDlgNRJP7S3zrleAWU%2Fimage.png?alt=media\&token=a8a734a3-eb2e-4b35-be2d-a7eb28dbfc89)

#### Facebook

<img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FYqTZPmemRHL4edHIuBWZ%2Fimage.png?alt=media&#x26;token=f62beeee-da9c-452c-b75b-e880a1075fe8" alt="" data-size="original">

#### Instagram

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F05Oe9jBjhuEulFH625Kx%2Fimage.png?alt=media\&token=c28d7777-94d3-4dcf-b1b4-417bb0492763)