Inbox

List social inbox conversations (newest activity first)

Returns one entry per conversation (the latest message in each), across Instagram and Facebook DMs, comments, and mentions, LinkedIn company-page comments and mentions (LinkedIn has no DMs via API), TikTok video comments (comments only; requires the TikTok comments authorization on the channel), YouTube video comments (comments only; each channel is checked once per day, YouTube has no comment webhooks), X DMs for workspaces that opted in to X DMs in the dashboard (X is DM-only; no history from before opt-in), and Threads replies on your posts plus mentions (requires a Threads connection with the reply-reading permission; currently rolling out). Cursor-paginated: follow pagination.next_cursor until it is null. Requires the inbox:read scope (API keys) or the access_social_inbox permission (OAuth/MCP).

get/inbox/conversations

Query parameters

limitinteger

Max conversations per page (1-100, default 25).

cursorstring

Opaque pagination cursor from a previous response.

platform'instagram' | 'facebook' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'threads'

Filter to a single platform.

type'dm' | 'comment' | 'mention'

Filter to a single conversation type.

unreadboolean

When true, only conversations with unread incoming messages.

Response

A page of conversations

Changes

No recorded changes to this endpoint across all 1 revision of this API.