Payload Media Types

Webhook Payload Media Types

Connectly webhooks support 4 media types that correspond to certain MIME types:

TypeDescriptionSupported MIME types


images in .jpeg, .png format

- image/jpeg - image/png

video (Coming soon!)

video files

- video/mp4 - video/3gpp


audio files and audio recordings

- audio/aac - audio/mp4 - audio/mpeg - audio/amr - audio/ogg - audio/ogg; codecs=opus


work documents, text files and all other file types that are not listed in the previous 3 categories

Most common MIMEs: - text/plain - application/pdf - application/ - application/msword - application/ - application/vnd.openxmlformats-officedocument.wordprocessingml.document - application/vnd.openxmlformats-officedocument.presentationml.presentation - application/vnd.openxmlformats-officedocument.spreadsheetml.sheet - application/

The media webhook payload has the following format:


  "timestamp": "1640204070",
  "sender": {
    "id": "+16315555500",
    "channelType": "whatsapp",
    "name": "Vasi from Connectly"
  "recipient": {
    "id": "+16044441234",
    "channelType": "whatsapp",
    "name": "connectlyai"
  "message": {
    "attachments": [
        "type": "audio",
        "url": ""

The media payload is stored under attachments. Connectly supports sending multiple attachments in one webhook event but currently, only ONE attachment is sent at a time. The type indicates the media type and the media file is accessible by visiting the url. If you download the media file from the URL programmatically then you should get the MIME type from the response headers.

Last updated