Inbox

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).

Returns messages in a conversation, oldest first, cursor-paginated. Requires the inbox:read scope (API keys) or the access_social_inbox permission (OAuth/MCP).

Marks every unread incoming message in the conversation as read and returns how many were updated. Requires the inbox:write scope (API keys) or the access_social_inbox permission (OAuth/MCP).

Sends a reply in an existing conversation (DM, comment, or mention) on Instagram, Facebook, LinkedIn, TikTok (comments only), YouTube (comments only), X (DM-only), or Threads (replies and mentions; needs a Threads connection with the reply permission, else 401 reauth_required). You can only reply to conversations that already exist in your inbox — the API cannot start new conversations (Instagram requires the user to message first, and cold outreach violates Meta policy). Direct-message replies must be within the platform's messaging window (24 hours since the user's last message); replies outside the window are rejected. TikTok replies are text-only, capped at 150 characters (400 validation_error beyond that), and can take a few minutes to appear on TikTok while they pass spam review. Each workspace can send up to 1,000 replies per rolling 24 hours (429 reply_limit_reached beyond that) — contact [email protected] if you need a higher limit. X DM replies debit 2 credits from the company balance before the send (auto-refunded if the send fails) and can return 402 insufficient_credits or 402 x_inbox_suspended. Requires the inbox:write scope (API keys) or the access_social_inbox permission (OAuth/MCP).

Hides (or unhides) a comment someone left on one of your posts, on the platform, as the post owner. Facebook, Instagram, TikTok, YouTube and Threads comments (Threads: incoming top-level replies only; Threads does not allow hiding nested replies). On YouTube "hide" sets the comment's moderation status to rejected, which removes it and its replies from public view; unhide publishes it again. The message keeps its place in the conversation and hidden flips on the returned message. A hidden comment no longer counts as unanswered. The account must have been connected with the moderation permission (Facebook pages_manage_engagement, Instagram instagram_business_manage_comments); 403 reconnect_required otherwise. Requires the inbox:write scope (API keys) or the access_social_inbox permission (OAuth/MCP).

Deletes a comment someone left on one of your posts, on the platform and from the inbox. Facebook, Instagram and TikTok comments only: YouTube's API does not let a channel delete other people's comments, hide those instead (POST /inbox/messages/{id}/hide). Replies under the deleted comment go with it (the platforms cascade the delete and the inbox mirrors that); their ids are returned. A comment that is already gone on the platform is still removed from the inbox. This cannot be undone. Requires the inbox:write scope (API keys) or the access_social_inbox permission (OAuth/MCP).

A work queue for answering the inbox. Returns the oldest (by default) item that still needs a reply, together with its conversation so far and the post it belongs to, so a reply can be drafted from one call. An item needs an answer when it is the customer's latest DM with no reply after it (Instagram/Facebook DMs within the 24-hour messaging window only, since Meta refuses replies outside it), or a comment/mention that has not been replied to and is not hidden. Replies typed in the native apps count as answers (they are mirrored into the inbox), so a thread a colleague answered on their phone is not served again. Instagram mentions are skipped (no reply path). Only unread items are served by default: marking a conversation read (POST /inbox/conversations/{id}/read) is how to skip one for good; pass include_read=true to include read-but-unanswered items. Looks at the last 30 days of activity. To chain the queue, pass include_next: true to the reply endpoint and it returns the next item in the same response. Requires the inbox:read scope (API keys) or the access_social_inbox permission (OAuth/MCP).