Documentation

API Reference
All Docs

WhatsApp Channels

Create and manage WhatsApp Channels (newsletters) for one-way broadcast updates.

What are WhatsApp Channels?

WhatsApp Channels (also known as newsletters) are a one-way broadcast feature built into WhatsApp. Unlike groups, only admins can post to a channel and subscribers receive updates in a dedicated "Updates" tab. They are ideal for announcements, news, and marketing updates to a large audience.

Creating a Channel

Create a WhatsApp Channel from the dashboard in a few steps:

  1. 1

    Connect a Baileys session

    Go to Sessions and ensure you have a connected Baileys (Direct Phone) session. WhatsApp Channels require a direct connection — they are not available via the Meta Business API.

  2. 2

    Open your session

    Click on a connected session to open its detail page. You will see a "WhatsApp Channels" section below the connection info.

  3. 3

    Create the channel

    Click "Create Channel", enter a name and optional description, then click "Create". The channel will be created on WhatsApp and saved in Neuron.

Channel names should be descriptive and recognizable — subscribers will see the name in their Updates tab.

Posting Updates

To post a message to your channel, click the Send icon on any channel card in the session detail page. Type your message and press Enter or click Send. All subscribers will receive the update instantly in their Updates tab.

Managing Channels

From the session detail page you can edit a channel's name and description (pencil icon), refresh metadata from WhatsApp to update the subscriber count (refresh icon), or delete the channel entirely (trash icon). Deleting a channel removes it from WhatsApp permanently.

Deleting a WhatsApp Channel is irreversible. All subscribers will lose access to the channel.

API Reference

All channel operations are available via the REST API under /api/v1/newsletters. Endpoints: GET / (list), POST / (create), GET /:id (detail), PUT /:id (update), DELETE /:id (delete), POST /:id/post (send message), POST /:id/refresh (re-fetch metadata).

Create a newsletter via API

curl -X POST /api/v1/newsletters \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channelId": "uuid", "name": "My Channel", "description": "Daily updates"}'

MCP Tools

Seven MCP tools are available for newsletter management: neuron_list_newsletters, neuron_create_newsletter, neuron_get_newsletter, neuron_update_newsletter, neuron_delete_newsletter, neuron_post_to_newsletter, and neuron_refresh_newsletter. Use these from Claude or any MCP-compatible client.

Post to a newsletter via MCP

// Using the neuron_post_to_newsletter tool
{
  "id": "newsletter-uuid",
  "text": "Hello subscribers! Here is today's update."
}