Documentation

Media

Media does not arrive inline in a webhook. When a file finishes synchronizing, WhatSyncs emits a media event with metadata and a short-lived, authenticated download URL.

The media event

whatsapp.media.synced

signed

     {          "event"  :     "whatsapp.media.synced"  ,          "id"  :     "evt_01H9X2M0P8TT41"  ,          "created_at"  :     "2026-03-04T09:43:22Z"  ,          "connection"  :     {     "id"  :     "conn_sales"  ,     "name"  :     "Sales"     }  ,          "message"  :     {            "id"  :     "msg_3EB0C9D1A7F9"  ,            "direction"  :     "outgoing"  ,            "type"  :     "document"  ,            "chat"  :     {     "id"  :     "chat_971500000000"     }          }  ,          "media"  :     {            "id"  :     "med_01H9X2K7Q4"  ,            "mime_type"  :     "application/pdf"  ,            "filename"  :     "villa-17-brochure.pdf"  ,            "size_bytes"  :     2517483  ,            "download_url"  :     "https://api.whatsyncs.com/v1/media/med_01H9X2K7Q4/download"  ,            "expires_at"  :     "2026-03-04T10:43:22Z"          }      }

Field	Description
`media.id`	Stable identifier for the file.
`media.mime_type`	Content type as reported by the message.
`media.filename`	Original filename where one was provided.
`media.size_bytes`	File size, so you can decide before downloading.
`media.download_url`	Authenticated URL. Requires your API key and expires.
`media.expires_at`	When the download URL stops working.

Downloading a file

GET /media/:id/download

200 OK

     curl     "https://api.whatsyncs.com/v1/media/med_01H9X2K7Q4/download"     \          -H     "Authorization: Bearer YOUR_API_KEY"     \          -o   villa-17-brochure.pdf

Storage

Most teams download the file when the media event arrives and store it wherever their records live — object storage, the CRM's file API, or an internal document store. Media remains retrievable from WhatSyncs, but a copy on your side is what makes it useful inside your own systems.

Supported types

Images (JPEG, PNG, WebP)
Video
Voice notes and audio files
PDFs
Documents and other file attachments

Availability depends on what the linked WhatsApp session exposes. WhatSyncs synchronizes what is available rather than guaranteeing every attachment.

Everything on this page works on the Free plan, including webhooks and full API access.

Start Free

The media event

whatsapp.media.synced

signed

     {          "event"  :     "whatsapp.media.synced"  ,          "id"  :     "evt_01H9X2M0P8TT41"  ,          "created_at"  :     "2026-03-04T09:43:22Z"  ,          "connection"  :     {     "id"  :     "conn_sales"  ,     "name"  :     "Sales"     }  ,          "message"  :     {            "id"  :     "msg_3EB0C9D1A7F9"  ,            "direction"  :     "outgoing"  ,            "type"  :     "document"  ,            "chat"  :     {     "id"  :     "chat_971500000000"     }          }  ,          "media"  :     {            "id"  :     "med_01H9X2K7Q4"  ,            "mime_type"  :     "application/pdf"  ,            "filename"  :     "villa-17-brochure.pdf"  ,            "size_bytes"  :     2517483  ,            "download_url"  :     "https://api.whatsyncs.com/v1/media/med_01H9X2K7Q4/download"  ,            "expires_at"  :     "2026-03-04T10:43:22Z"          }      }

Field	Description
`media.id`	Stable identifier for the file.
`media.mime_type`	Content type as reported by the message.
`media.filename`	Original filename where one was provided.
`media.size_bytes`	File size, so you can decide before downloading.
`media.download_url`	Authenticated URL. Requires your API key and expires.
`media.expires_at`	When the download URL stops working.