Newsletters

Mark newsletter messages as viewed

Marks one or more newsletter/channel messages as viewed on behalf of the authenticated WUTS device session. Server IDs are the numeric server message identifiers for the channel.

POST
/newsletters/{jid}/read

Marks one or more newsletter/channel messages as viewed on behalf of the authenticated WUTS device session. Server IDs are the numeric server message identifiers for the channel.

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 whose messages should be marked viewed (e.g. 120363039000000000@newsletter).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/newsletters/string/read" \  -H "Content-Type: application/json" \  -d '{    "server_ids": [      "101",      "102",      "103"    ]  }'
{  "success": true,  "newsletter": "120363039000000000@newsletter",  "count": 3}
{  "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"}

List subscribed newsletters GET

Returns the WhatsApp newsletters/channels the connected account is subscribed to.

Send media to a newsletter POST

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.