# Files

All examples below must be sent within the **body** field of a message as shown below

{% code lineNumbers="true" %}

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

{% endcode %}

## Single file message

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "files": [
      {
        "contentType": "video/mp4",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media"
      }
    ]
  }
} 
```

{% endcode %}

#### MMS

Only SMS channels that are MMS capable support file messages. See [here](https://docs.bird.com/api/supported-channels/programmable-sms#checking-if-a-channel-is-mms-capable)

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FMglqe8PEOnq6RJ7fqe2a%2Fimage.png?alt=media\&token=902a720c-6075-4591-9963-341f627b1594)

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F3RTIfnmqeCItB69u6gD8%2Fimage.png?alt=media\&token=b524ccd9-1948-4cd0-8fc1-34c5c8552f05)

#### Google RCS

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F6g2A4nsXHxECv1ROoDDE%2Fimage.png?alt=media&#x26;token=cf1b20b0-b0c2-4917-8e9a-929f43d83c66" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FH4Tv6TOaMrvFSDAXdRAn%2Fimage.png?alt=media\&token=5cbe2660-7093-4365-95bb-fd67255fe884)

#### Instagram

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F1ODxsic7N7yRYVxHalDT%2Fimage.png?alt=media\&token=ef769850-4623-42cc-a846-5fdf787c3e56)

#### Line

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FKSpcYomDnSVXiehUBtYc%2FSingle%20file%20message.png?alt=media&#x26;token=dc9c51f5-33c3-4b96-9f46-aebd94f9ee4c" alt=""><figcaption></figcaption></figure></div>

## Single file message with text

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "text": "Single file message",
    "files": [
      {
        "contentType": "video/mp4",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media"
      }
    ]
  }
} 
```

{% endcode %}

#### MMS&#x20;

Only SMS channels that are MMS capable support file messages. See [here](https://docs.bird.com/api/supported-channels/programmable-sms#checking-if-a-channel-is-mms-capable)

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FKaKtWU2bfpySfZeQjydQ%2Fimage.png?alt=media\&token=48dc7f68-251c-43c0-944f-e3d3b7dfc61c)

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2Fn3zw3eZIEPC2MEYIMbbR%2Fimage.png?alt=media\&token=138f3382-ca76-41f4-b6b4-74ac77199a89)

#### Google RCS

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FXofUiMy3qbn7yMdvd78w%2Fimage.png?alt=media&#x26;token=062eb851-1cb2-48dc-8f9f-0d016b190de7" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FxoHzWTGOwawmeKB4GKfQ%2Fimage.png?alt=media\&token=6f811921-7893-4d5d-9ba1-307cdadf7ae0)

#### **Line**

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FOzrQioFbzi2Bt4yWTxFQ%2Fsingle%20file%20message.png?alt=media&#x26;token=95374ac2-2103-4586-b253-0f239b5d922b" alt=""><figcaption></figcaption></figure></div>

## Multiple file message

### Multiple files message

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "text": "Multiple files message",
    "files": [
      {
        "contentType": "video/mp4",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media"
      },
      {
        "contentType": "audio/m4a",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FbgnxOoaF4aHSHUzMFCna%2Faudio.mp3?alt=media"
      }
    ]
  }
}
```

{% endcode %}

#### MMS&#x20;

Only SMS channels that are MMS capable support file messages. See [here](https://docs.bird.com/api/supported-channels/programmable-sms#checking-if-a-channel-is-mms-capable)

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FoNFLu3Stao1rX73NOPZX%2Fimage.png?alt=media\&token=d2aac934-185a-4454-b257-6cc2993d950b)

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FKC2PxxRJPDFA0o81bq5B%2Fimage.png?alt=media\&token=59a63c62-9617-4517-aa02-7a80cc1addb5)

#### Google RCS

Audio/mpeg not supported on Google RCS. Application/PDF used in this example

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F7pmhSmJk6FbI1CRDYPg5%2Fimage.png?alt=media&#x26;token=6d17a3ef-4487-4270-a3fc-69774c1f5e1c" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FR3e9HGleLmvJWdESJeJ5%2Fimage.png?alt=media\&token=264b2b1e-54fc-447d-ab20-16775f39a011)

#### Instagram

Audio/mpeg not supported on Instagram. Audio/wav used in this example

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FOQQiZ5He16nuk0jfCU8g%2Fimage.png?alt=media\&token=f0d7bd9d-9ff9-41ab-859a-0017e639cc96)

#### Line

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FGD5RY29BgMAY3V8sT80k%2FMultiple%20file%20message%20with%20audio.png?alt=media&#x26;token=fe321e08-7964-4138-b591-756c5a987a96" alt=""><figcaption></figcaption></figure></div>

### Multiple files message with filename

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "text": "Multiple files message",
    "files": [
      {
        "contentType": "video/mp4",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media"
      },
      {
        "contentType": "application/pdf",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FPnRToYX2feW96HAOrh4x%2Fdocument.pdf?alt=media",
        "filename": "passport.pdf"
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FCseheJha3J7mrlyh8mnP%2Fimage.png?alt=media\&token=fe2ddd08-e4f4-4086-8dcd-69ea683cf590)

#### Google RCS

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FkZmtzCtGVmuXnUgw0yGE%2Fimage.png?alt=media&#x26;token=87451ef3-7f4e-4d28-ad05-56cd52aeadf7" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FvPdGa8ISi7xvp4HUXmH7%2Fimage.png?alt=media\&token=9e88e7f4-7552-4879-880c-141ac1b4ef3d)

#### Line

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FYoFHlcbotJLUVbS7oq7t%2FMultiple%20files%20message%20with%20filename.png?alt=media\&token=a8a62800-68b3-4053-8184-aaf96d68d986)

## Single file message with actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "text": "Single file message",
    "files": [
      {
        "contentType": "video/mp4",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media"
      }
    ],
    "actions": [
      {
        "type": "postback",
        "postback": {
          "text": "Postback action"
        }
      },
      {
        "type": "reply",
        "reply": {
          "text": "Reply action"
        }
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F137DLTuYwT0R4sISFbFB%2Fimage.png?alt=media\&token=0598c9c5-827d-41e9-afac-6bcab23f6b0f)

#### Google RCS

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FpQuaWDkgOQjeTjvYJcsK%2Fimage.png?alt=media&#x26;token=9a01b957-2317-44d9-88a4-17bcaedf3478" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FsTIKNtUiIqUuquaIZ0yV%2Fimage.png?alt=media\&token=7ef06eb3-1523-465c-a81a-cd188b2dbf95)

#### Instagram

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FAuZK3TRu2Bm21wFWnA8l%2Fimage.png?alt=media\&token=ba0a235c-ecb0-4ca1-bbc7-180dab772b6f)

## Multiple file message with actions

### Miltiple files mesage with 2 postback actions and 1 reply action

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "text": "Multiple files message",
    "files": [
      {
        "contentType": "video/mp4",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media"
      },
      {
        "contentType": "application/pdf",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FPnRToYX2feW96HAOrh4x%2Fdocument.pdf?alt=media",
        "filename": "passport.pdf"
      }
    ],
    "actions": [
      {
        "type": "postback",
        "postback": {
          "text": "Postback action 1",
          "payload": "postback-payload-1"
        }
      },
      {
        "type": "postback",
        "postback": {
          "text": "Postback action 2",
          "payload": "postback-payload-2"
        }
      },
      {
        "type": "reply",
        "reply": {
          "text": "Reply action"
        }
      }
    ]
  }
}
```

{% endcode %}

#### WhatsApp

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F4l2XmyldX23JoP5njlbo%2Fimage.png?alt=media\&token=c3424d2e-bb9d-4596-ab28-0e5a03649bd1)

#### Google RCS

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FxZFQnoGc43Aw4pj85wEm%2Fimage.png?alt=media&#x26;token=0e036e72-14f3-4b00-a42e-adab6fb3589a" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2F5CTDhcd0UZcV5d62luNR%2Fimage.png?alt=media\&token=70321372-80ba-4bb5-8025-aac33507500e)

#### Instagram

\*PDF not supported. Example using audio/wav file

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FUlq5eRNheC1pSINnbMfz%2Fimage.png?alt=media\&token=152686c4-55c1-41dd-9e6e-9a8ea0581298)

### Multiple files message with 4 postback actions

#### Body

{% code lineNumbers="true" %}

```json
{
  "type": "file",
  "file": {
    "files": [
      {
        "contentType": "video/mp4",
        "altText": "First file label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FtXMQ4lIinia9ehf4EpC4%2Fvideo.mp4?alt=media",
        "filename": "recording.mp4"
      },
      {
        "contentType": "application/pdf",
        "altText": "Second file label",
        "mediaUrl": "https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FPnRToYX2feW96HAOrh4x%2Fdocument.pdf?alt=media",
        "filename": "passport.pdf"
      }
    ],
    "text": "Multiple files 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"
      },
      {
        "postback": {
          "payload": "postback-payload-3",
          "text": "Postback action 3"
        },
        "type": "postback"
      },
      {
        "postback": {
          "payload": "postback-payload-4",
          "text": "Postback action 4"
        },
        "type": "postback"
      }      
    ]
  }
}
```

{% endcode %}

#### Google RCS

<div align="left"><figure><img src="https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FGA44lg0nvNy9GXUzvDLP%2Fimage.png?alt=media&#x26;token=b88a1177-81cf-46b3-9564-6b32161b7744" alt="" width="375"><figcaption></figcaption></figure></div>

#### Facebook

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2Ff6oRZgCUUbZgMSWd2GAZ%2Fimage.png?alt=media\&token=8f11ce4d-4210-4e57-a90b-95ea1913d0d2)

#### Instagram

\*PDF not supported. Example using audio/wav file

![](https://3210271997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdnJZeZvhOMhDQA8SpjQM%2Fuploads%2FE0p7yOkw0zZJPav7ozsE%2Fimage.png?alt=media\&token=d5eb9e70-8b18-4cce-ac28-5184f3253455)