Send media to a newsletter

Uploads and publishes an image, video, or document to a WhatsApp newsletter/channel via the authenticated WUTS device session. Media may be provided inline as base64 (optionally a data URI) or fetched from a remote URL; the combined payload must not exceed 32 MB.

Authorization

bearerAuth

AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Path Parameters

jid*string

Newsletter/channel JID that will receive the media post (e.g. 120363039000000000@newsletter).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

media_type*string

Type of media to publish. Compared case-insensitively; must resolve to image, video, or document.

media?string

Base64-encoded media payload. Accepts a raw base64 string or a data URI (data:;base64,); when a data URI is given and mime_type is omitted, the mime type is inferred from it. Required if media_url is not provided. Decoded size must not exceed 32 MB.

media_url?string

Remote URL to download the media from. Required if media is not provided. Downloaded size must not exceed 32 MB.

caption?string

Optional caption to attach to the image, video, or document.

file_name?string

File name shown for document posts. Required when media_type is document.

mime_type?string

Optional MIME type override. When omitted, it is inferred from the data URI, the download Content-Type header, or content sniffing.

thumbnail?string

Optional base64-encoded JPEG thumbnail (raw base64 or data URI) applied to image and video posts.

Response Body

`application/json`

curl -X POST "https://example.com/newsletters/string/media" \  -H "Content-Type: application/json" \  -d '{    "media_type": "image",    "media_url": "https://cdn.example.com/posts/launch-banner.jpg",    "caption": "Our new launch is live!",    "mime_type": "image/jpeg"  }'

{  "success": true,  "message_id": "3EB0XXXX1234567890ABCDEF",  "timestamp": "2026-06-15T18:31:10Z",  "newsletter": "120363039000000000@newsletter",  "status_type": "image"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Send media to a newsletter

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`