> For the complete documentation index, see [llms.txt](https://docs.bird.com/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/api/channels-api/message-types/images.md).

# Images

{% 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 %}

## Single image message

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "Label of first image",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ]
  }
}
```

{% endcode %}

#### MMS

Only SMS channels that are MMS capable support image messages. See [here](/api/channels-api/supported-channels/programmable-sms.md#checking-if-a-channel-is-mms-capable)

![](/files/byPYObylAKEfU6Uys5wM)

#### WhatsApp

![](/files/ndHZGwP1DO2dpwKcch8j)

#### Google RCS

<div align="left"><figure><img src="/files/x2lVEi4vRIpJVytu8cMO" alt="" width="306"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/P3JxB0ppIzhvHiV0P1CI)

#### Instagram

![](/files/F5rMohxHcGroD07OcyrD)

#### Line

<div align="left"><figure><img src="/files/Pg64XZwuk0zplg8AFfV2" alt=""><figcaption></figcaption></figure></div>

## Single image message with text

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "Label of first image",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ],
    "text": "Single image message"
  }
}
```

{% endcode %}

#### MMS

Only SMS channels that are MMS capable support image messages. See [here](/api/channels-api/supported-channels/programmable-sms.md#checking-if-a-channel-is-mms-capable)

![](/files/eUDtnDiG3YV2rRe8MW9k)

#### WhatsApp

![](/files/YDx2ZMWhsdODSUjMuIvV)

#### Google RCS

<div align="left"><figure><img src="/files/BZoBmyEAJ076Aev7atBF" alt="" width="370"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/awiPMVbsH6I34tqXAj4J)

#### Instagram

![](/files/ly0027Xxx0qOlCm7rLr2)

#### Line

<div align="left"><figure><img src="/files/MZ7hx7MMpvQYbhXp3jnl" alt=""><figcaption></figcaption></figure></div>

## Multiple image message

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "Label of first image",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FrEM9zztd8SEiJS6RQuR3%2Fimage.png?alt=media"
      },
      {
        "altText": "Label of second image",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ],
    "text": "Multiple images message"
  }
}
```

{% endcode %}

#### MMS

Only SMS channels that are MMS capable support image messages. See [here](/api/channels-api/supported-channels/programmable-sms.md#checking-if-a-channel-is-mms-capable)

![](/files/c0VzkDbCNr2XpjhLgXyF)

#### WhatsApp

![](/files/pCZLTSF4CCWySPg7g8vW)

#### Google RCS

<div align="left"><figure><img src="/files/unAgkEEvBuWwRv1HGvxS" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/TbvPK9ZXd3AL1wxiquIA)

#### Instagram

![](/files/p1ZUQZgZiSbl3jXMkmdw)

#### Line

<div align="left"><figure><img src="/files/uiXdlWmlAIJ11MeeU8qH" alt=""><figcaption></figcaption></figure></div>

## Single image message with actions

### Single image message with postback actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "Image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ],
    "text": "Single image message with postback actions",
    "actions": [
      {
        "type": "postback",
        "postback": {
          "payload": "postback-payload-1",
          "text": "Postback option 1"
        }
      },
      {
        "postback": {
          "payload": "postback-payload-2",
          "text": "Postback option 2"
        },
        "type": "postback"
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](/files/MO1lUM1mTsQFNcMel4yF)

#### Google RCS

<div align="left"><figure><img src="/files/R3tBlLPEUbNQVcxpIJuz" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/2fYW7gu6UMtZt7lDnl91)

#### Instagram

![](/files/niHCROyikYyT29MtmZM1)

#### Line

<div align="left"><figure><img src="/files/tr9GZlfAQWkTqE9UwiSe" alt=""><figcaption></figcaption></figure></div>

### Single image message with reply actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "text": "Single image message with reply actions",
    "images": [
      {
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media",
        "altText": "Image label"
      }
    ],
    "actions": [
      {
        "type": "reply",
        "reply": {
          "text": "Reply action 1"
        }
      },
      {
        "type": "reply",
        "reply": {
          "text": "Reply action 2"
        }
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](/files/cjSA01Mbf7g9trSMMgmG)

#### Google RCS

<div align="left"><figure><img src="/files/4eHuumH1JolIYmlN9VUe" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/xNzgbqEJ4rpGeAmPMN3J)

#### Instagram

![](/files/6JPKzZzPVnHIkvwlckQz)

#### Line

<div align="left"><figure><img src="/files/Yn4Ef5HSrDUxmtLpPud6" alt=""><figcaption></figcaption></figure></div>

### Single image message with postback and reply actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "text": "Single image message with postback and reply actions",
    "images": [
      {
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media",
        "altText": "Image label"
      }
    ],
    "actions": [
      {
        "type": "postback",
        "postback": {
          "text": "Postback action",
          "payload": "postback-payload"
        }
      },
      {
        "type": "reply",
        "reply": {
          "text": "Reply action"
        }
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](/files/J6uQC5n9L4j60wmAjOvC)

#### Google RCS

<div align="left"><figure><img src="/files/PjA8bW33IonsxZsxd3r4" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/Bw8yYkbv8uResATogm4P)

**Instagram**

![](/files/5mTRO72LRz7vtIqWcTbO)

#### Line

<div align="left"><figure><img src="/files/Kji0XPUR1Q7FJ7LadvpO" alt=""><figcaption></figcaption></figure></div>

## Multiple image message with actions

### Multiple image message with labels and postback

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "First image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FrEM9zztd8SEiJS6RQuR3%2Fimage.png?alt=media"
      },
      {
        "altText": "Second image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ],
    "text": "Multiple images message with postback actions",
    "actions": [
      {
        "type": "postback",
        "postback": {
          "payload": "postback-payload-1",
          "text": "Postback action 1"
        }
      },
      {
        "postback": {
          "payload": "postback-payload-2",
          "text": "Postback action 2"
        },
        "type": "postback"
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](/files/HkBQbcTEdOvmGHSuBqZ0)

#### Google RCS

<div align="left"><figure><img src="/files/KNlD5mZ25B1SvXXaKXPy" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/cRj4iZUg4IY2xiKwUWg9)

#### Instagram

![](/files/gRTzCod2Fcgw6GobxAh2)

#### Line

<div align="left"><figure><img src="/files/b9tLId8Oq0aHKZeKZA3l" alt=""><figcaption></figcaption></figure></div>

### Multiple images message with reply actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "First image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FrEM9zztd8SEiJS6RQuR3%2Fimage.png?alt=media"
      },
      {
        "altText": "Second image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ],
    "text": "Multiple images message with reply actions",
    "actions": [
      {
        "type": "reply",
        "reply": {
          "text": "Reply action 1"
        }
      },
      {
        "reply": {
          "text": "Reply action 2"
        },
        "type": "reply"
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](/files/n5L7tAzeMiTphyLVt0W2)

#### Google RCS

<div align="left"><figure><img src="/files/ZRV1IO17IQ2hvjSuVz7c" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/afeNlzclWXBQdQt5dOno)

#### Instagram

![](/files/ByWsfdKSSRhWyi0QTAE2)

#### Line

<div align="left"><figure><img src="/files/luLXCIVLzGsfa3pbs0PD" alt=""><figcaption></figcaption></figure></div>

### Multiple images message with labels, postback and reply actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "image",
  "image": {
    "images": [
      {
        "altText": "First image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FrEM9zztd8SEiJS6RQuR3%2Fimage.png?alt=media"
      },
      {
        "altText": "Second image label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FRPPgQAGyZE7rvIh3WM2Z%2Fimage2.avif?alt=media"
      }
    ],
    "text": "Multiple images message with postback and reply actions",
    "actions": [
      {
        "type": "postback",
        "postback": {
          "payload": "postback-payload",
          "text": "Postback action"
        }
      },
      {
        "reply": {
          "text": "Reply action"
        },
        "type": "reply"
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](/files/o6Q8PFcIfo5d79p76Osa)

#### Google RCS

<div align="left"><figure><img src="/files/frkwyqsEaos5XySgcdfG" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](/files/FfCLYX5jWapK0qsWWedx)

#### Instagram

![](/files/1iqBdwMcb7fO8DuW2PVX)

#### Line

<div align="left"><figure><img src="/files/s5Yw99Mc6ct85jCyfrIN" alt=""><figcaption></figcaption></figure></div>