Payload Media Types

Webhook Payload Media Types

Connectly webhooks support 4 media types that correspond to certain MIME types:
Supported 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.