# CLI Inbox Commands

Read and reply to DMs, comments, and mentions from Instagram, Facebook, and
LinkedIn company pages. See the [Social Inbox guide](/inbox) 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:

```bash
omnisocials inbox:list --platform instagram --type dm --unread
```

Read a conversation and reply:

```bash
omnisocials inbox:messages 17845123456789
omnisocials inbox:reply 17845123456789 --text "Thanks for reaching out! Sending you the details now."
omnisocials inbox:read 17845123456789
```

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.