CLI Inbox Commands
Read and reply to DMs, comments, and mentions from Instagram, Facebook, and LinkedIn company pages. See the Social Inbox guide for concepts, platform coverage, and reply limits.
Inbox access is opt-in: your API key needs the inbox:read scope for reading and
inbox:write for replying and marking read. Enable them when creating the key
under Settings -> API.
Commands
| Command | Description |
|---|---|
inbox:list | List conversations (latest message each) with participant, unread count, and related post. Flags: --platform <instagram|facebook|linkedin>, --type <dm|comment|mention>, --unread, --limit, --cursor. Requires inbox:read |
inbox:messages <conversation-id> | Full message history for one conversation, oldest to newest. Flags: --limit, --cursor. Requires inbox:read |
inbox:read <conversation-id> | Mark a conversation's messages as read. Requires inbox:write |
inbox:reply <conversation-id> | Send a reply. Flags: --text (required), --attachment-url, --attachment-type. Requires inbox:write |
Conversation ids can contain : and () (LinkedIn URNs); the CLI URL-encodes them
for you. Lists are cursor-paginated: pass the cursor from the previous response
to fetch the next page.
Examples
Triage unread Instagram DMs:
Code
Read a conversation and reply:
Code
Replies are limited to existing conversations (no cold outreach), the platform's messaging window applies, and each workspace can send up to 1,000 replies per rolling 24 hours.