Channels

Channels are WhatsApp newsletters. Channel JIDs end in @newsletter, and channel operations require a paired, connected token.

Discover channels

List channels followed by the linked device:

GET /api/v1/sessions/{sessionId}/newsletters/subscribed
Authorization: Bearer <api_key>

Fetch metadata:

GET /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}
Authorization: Bearer <api_key>

Search the public directory:

POST /api/v1/sessions/{sessionId}/newsletters/search
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "searchText": "product updates",
  "limit": 20
}

You can also fetch recommended channels, similar channels, directory lists, category previews, invite metadata, and domain preview support.

Follow and mute

POST /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/follow
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "action": "follow"
}

Use unfollow, mute, or unmute for the other actions.

Create and update a channel

POST /api/v1/sessions/{sessionId}/newsletters
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "name": "Product updates",
  "description": "Release notes and customer announcements"
}

Update editable fields:

PATCH /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "name": "Product announcements"
}

Post and moderate messages

Post a text message:

POST /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/messages
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "text": "Version 2.1 is now available."
}

Post richer channel content:

POST /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/messages/rich
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "content": {
    "type": "image",
    "mediaUrl": "https://example.com/release.jpg",
    "mimetype": "image/jpeg",
    "caption": "Version 2.1 is now available."
  }
}

The rich endpoint supports text, image, video, audio, document, sticker, location, contact, and poll content. For media posts, provide a URL that WADial can fetch. Edit or delete a post:

PATCH /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/messages/{messageId}
DELETE /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/messages/{messageId}
Authorization: Bearer <api_key>

React to a channel message:

POST /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/messages/react
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "parentMessageServerId": 12345,
  "reactionCode": "🔥"
}

Administer a channel

Admin endpoints support fetching admin info, capabilities, followers, insights, moderation reports, enforcements, pending invites, poll voters, and reaction senders. You can also invite admins, revoke invites, accept an admin invite, transfer ownership, demote admins, and delete a channel.

Get started

Guides

Build with the API

API Reference

Discover channels

Follow and mute

Create and update a channel

Post and moderate messages

Administer a channel

​Discover channels

​Follow and mute

​Create and update a channel

​Post and moderate messages

​Administer a channel

Discover channels

Follow and mute

Create and update a channel

Post and moderate messages

Administer a channel