Inbox API

Query incoming messages stored on the platform. The Inbox API provides endpoints for listing messages, viewing conversations, and managing read status.

List Incoming Messages

Retrieve incoming messages with optional filtering and pagination.

Parameter	Type	Default	Description
limit	number	50	Maximum records to return
offset	number	0	Number of records to skip
from	string	—	Filter by sender phone number
messageType	string	—	Filter by type (text, image, etc.)
phoneNumberId	string	—	Filter by receiving business number
unreadOnly	boolean	false	Only return unread messages
since	string	—	ISO timestamp to filter messages after

Get Conversations

Retrieve a list of unique conversations grouped by sender, including the last message preview and unread count.

Get Conversation Messages

Retrieve all messages from a specific sender (conversation thread view).

Get Message by ID

Retrieve a specific incoming message by its WhatsApp message ID.

Mark Message as Read

Mark a specific incoming message as read. This also sends a read receipt to the sender via WhatsApp.

Mark Conversation as Read

Mark all messages from a specific sender as read.

Get Inbox Statistics

Retrieve aggregate statistics: total messages, unread count, messages by type, and messages by phone number.

Get Messages by Phone Number

Retrieve all messages received by a specific business phone number.

C# Example

// Fetch unread messages
var response = await client.GetAsync(
    "https://app.waconnect.me/api/inbox?unreadOnly=true&limit=20");
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

// Mark a message as read
var msgId = "wamid.HBgLMTU1NTEyMzQ1NjcVAgASGCA0";
await client.PostAsync(
    $"https://app.waconnect.me/api/inbox/message/{msgId}/read",
    new StringContent(""));C#