# 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/OZNJaMtjaaP71s37Itvr)

#### WhatsApp

![](/files/y0VbJf8oQx8XbwbHpMxZ)

#### Google RCS

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

#### Facebook

![](/files/o535fOPmcU3nksFphsMj)

#### Instagram

![](/files/9jw1pVxaTJeCuniGezIi)

#### Line

<div align="left"><figure><img src="/files/sfrfCFBSRSJZNoKXc6XY" 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&#x20;

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/OXd1nMhYG83GaJCxijwK)

#### WhatsApp

![](/files/5x1a4vgga1DYQETFuK4e)

#### Google RCS

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

#### Facebook

![](/files/V9jQR6WCb2XhoVVxbHJ8)

#### Instagram&#x20;

![](/files/fNAyf7AwZO5mOcP2xgyZ)

#### Line

<div align="left"><figure><img src="/files/1ennfZHCeU2EAe7LIYRo" 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&#x20;

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/gB4TXQdRQCuVS4fsmFuv)

#### WhatsApp

![](/files/E8MKtOJQP9T6ykUIhLPJ)

#### Google RCS

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

#### Facebook

![](/files/VjK3ZCFXq9vSeOAQNnIz)

#### Instagram&#x20;

![](/files/FqTJVybbUJGcZr6qwLBI)

#### Line

<div align="left"><figure><img src="/files/J99zhz0jPJDY0QgF1E4p" 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/X3wzN2KqdD057hOKUWsd)

#### Google RCS

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

#### Facebook

![](/files/5ss5pKQgTfrILS5IMbe1)

#### Instagram

![](/files/jyw2crNYhQc3r2yXwfOC)

#### Line

<div align="left"><figure><img src="/files/835mLmwiCUqhxsmoJSKU" 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/DLAgANJLGQhKQyplhCAv)

#### Google RCS

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

#### Facebook

![](/files/aFArJYfxvWP3dLTzp8Nm)

#### Instagram

![](/files/LLnf0QYWiHTdq8bbfISf)

#### Line

<div align="left"><figure><img src="/files/QgIFlMFJk3d3baRCY8ua" 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/dF5pKlqfua8jNboZLMWw)

#### Google RCS

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

#### Facebook

![](/files/NYANbpf1wJAEI3E68v8i)

**Instagram**

![](/files/tCpuDxFnBjg7Ogi96rQG)

#### Line

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

## Multiple image message with actions

### Multiple image message with labels and postback&#x20;

#### 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/CAQdAdU8gdNr8kC3cznL)

#### Google RCS

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

#### Facebook

![](/files/aTHbMAYwuxy61gTou6uE)

#### Instagram

![](/files/Hqmr8FEaIMyOk5aX0jFS)

#### Line

<div align="left"><figure><img src="/files/V3aPFt5wJUCdtWGWE9eW" 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/Ep8Pe6FyKy6P9iswiZxQ)

#### Google RCS

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

#### Facebook

![](/files/qT9DKk7uh6bzbIXeytcV)

#### Instagram

![](/files/KuPSBpYLdDfRkW3MffOV)

#### Line

<div align="left"><figure><img src="/files/BKXT7kNyOWIWTFSp6mmc" 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/cmRKIXCPo8b0ha3A6tPJ)

#### Google RCS

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

#### Facebook

![](/files/t00RAls2JJ7cyqWeeefI)

#### Instagram

![](/files/5o4dHksPkkptDcGbxouy)

#### Line

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/api/channels-api/message-types/images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.