Inbox

The inbox commands let you triage the unified social inbox from the terminal: list conversations, read message threads, mark them read/resolved, reply with text and media, toggle inbox subscriptions per account, and manage reusable saved replies.

All commands accept the global flags: --json (default) / --table, --verbose, --api-key <key>, and --api-url <url>. You can also set SOME_API_KEY and SOME_API_URL in your environment.

Conversations

inbox:list

List inbox conversations.

so-me inbox:list [options]

The API endpoint (GET /v1/inbox/conversations) only paginates — every other filter (--status, --platform, --type, --read, --unread, --search) is applied client-side to the current page. Increase --limit if you need filters to span more conversations.

Option	Description	Default
`--status <status>`	Filter by status: `resolved`, `unresolved`, `archived`	—
`--platform <platform>`	Filter by platform: `facebook`, `instagram`, `twitter`, `linkedin`, `tiktok`, `youtube`, `threads`, `whatsapp`	—
`--type <type>`	Filter by type: `message`, `comment`, `mention`	—
`--read`	Show only read conversations	—
`--unread`	Show only unread conversations	—
`--search <query>`	Search by sender name, message text, or page name	—
`--limit <number>`	Conversations per page	`50`
`--page <number>`	Page number	`1`

Examples

# Unresolved conversations
so-me inbox:list --status unresolved

# Facebook comments only
so-me inbox:list --platform facebook --type comment

# Only unread conversations
so-me inbox:list --unread

# Combine filters: unread Instagram messages
so-me inbox:list --platform instagram --unread --type message

# Search by sender / message / page name
so-me inbox:list --search "john"

# Widen the page so client-side filters cover more threads
so-me inbox:list --limit 100

# Page through results, table view
so-me inbox:list --page 2 --limit 50 --table

inbox:messages

Get messages in a conversation thread.

so-me inbox:messages <thread-id>

string

required

Thread ID of the conversation whose messages you want to fetch.

Examples

# Fetch a thread's messages
so-me inbox:messages 550e8400-e29b-41d4-a716-446655440000

# Pull only the message bodies via jq
so-me inbox:messages 550e8400-... | jq '.[].message'

inbox:read

Mark a conversation as read (sets isSeen: true).

so-me inbox:read <thread-id>

string

required

Thread ID of the conversation to mark as read.

Examples

# Mark a single conversation read
so-me inbox:read 550e8400-e29b-41d4-a716-446655440000

# Mark every unread conversation as read
so-me inbox:list --unread --limit 100 \
  | jq -r '.[].id' \
  | xargs -I {} so-me inbox:read {}

inbox:resolve

Mark a conversation as resolved, unresolved, or archived.

so-me inbox:resolve <thread-id> --status <status>

string

required

Thread ID of the conversation to update.

Option	Description
`--status <status>`	New status: `resolved`, `unresolved`, `archived` (required)

Examples

# Resolve a conversation
so-me inbox:resolve 550e8400-... --status resolved

# Re-open a conversation
so-me inbox:resolve 550e8400-... --status unresolved

# Archive a conversation
so-me inbox:resolve 550e8400-... --status archived

inbox:delete

Delete one or more conversations. Prompts for confirmation unless --yes is passed. Each thread is deleted individually, and partial failures are reported.

so-me inbox:delete <thread-ids...> [options]

string[]

required

One or more thread IDs to delete (space-separated).

Option	Description
`-y, --yes`	Skip the confirmation prompt

Examples

# Delete a single conversation (prompts to confirm)
so-me inbox:delete 550e8400-e29b-41d4-a716-446655440000

# Delete several conversations without confirmation
so-me inbox:delete 550e8400-... 660e8400-... 770e8400-... --yes

# Delete all archived conversations
so-me inbox:list --status archived --limit 100 \
  | jq -r '.[].id' \
  | xargs so-me inbox:delete --yes

Replies

inbox:reply

Reply to a conversation with text, files, or both. At least one of --message, --image, --video, --audio, or --file is required. Media flags are sent as typed attachments (image, video, audio, document).

so-me inbox:reply <thread-id> [options]

string

required

Thread ID of the conversation to reply to.

Option	Description
`--message <text>`	Reply text message
`--image <urls...>`	Image URL(s) to attach (space-separated)
`--video <url>`	Video URL to attach
`--audio <url>`	Audio URL to attach
`--file <url>`	Document URL to attach

Examples

# Text-only reply
so-me inbox:reply 550e8400-... --message "Thanks!"

# Text with an image
so-me inbox:reply 550e8400-... --message "Check this" --image https://cdn.example.com/photo.jpg

# Multiple images
so-me inbox:reply 550e8400-... --image https://cdn.example.com/1.jpg https://cdn.example.com/2.jpg

# Video attachment
so-me inbox:reply 550e8400-... --video https://cdn.example.com/clip.mp4

# Document attachment
so-me inbox:reply 550e8400-... --file https://cdn.example.com/doc.pdf

# Reply with an emoji
so-me inbox:reply 550e8400-... --message "Here you go 😊"

Subscriptions

These commands accept either an account ID (UUID) or a platform name (e.g. twitter, facebook). When a platform name matches multiple connected accounts, the CLI prompts you to pick one. If no matching account exists, inbox:subscribe / inbox:unsubscribe exit successfully with a hint to connect one first.

inbox:subscribe

Enable inbox for a social account so it starts receiving messages, comments, and mentions.

so-me inbox:subscribe <id-or-platform>

string

required

Account ID (UUID) or platform name (twitter, facebook, etc.).

Examples

# Enable by platform name
so-me inbox:subscribe facebook

# Enable by account ID
so-me inbox:subscribe 550e8400-e29b-41d4-a716-446655440000

inbox:unsubscribe

Disable inbox for a social account.

so-me inbox:unsubscribe <id-or-platform>

string

required

Account ID (UUID) or platform name (twitter, facebook, etc.).

Examples

# Disable by platform name
so-me inbox:unsubscribe twitter

# Disable by account ID
so-me inbox:unsubscribe 550e8400-e29b-41d4-a716-446655440000

inbox:enable

Alias for inbox:subscribe.

so-me inbox:enable <id-or-platform>

string

required

Account ID (UUID) or platform name.

Example

so-me inbox:enable instagram

inbox:disable

Alias for inbox:unsubscribe.

so-me inbox:disable <id-or-platform>

string

required

Account ID (UUID) or platform name.

Example

so-me inbox:disable instagram

Saved Replies

Saved replies are reusable response templates you can attach files to and pull into the inbox.

inbox:saved-replies

List all saved replies, or get a single saved reply by ID.

so-me inbox:saved-replies [id]

string

Optional saved reply ID. When provided, returns details for that single reply; otherwise lists all saved replies.

Examples

# List all saved replies
so-me inbox:saved-replies

# Get one saved reply by ID
so-me inbox:saved-replies 7c2d4e8f-1234-5678-9abc-def012345678

# List as a table
so-me inbox:saved-replies --table

inbox:create-reply

Create a saved reply with text, files, or both. At least one of --text or --file is required.

so-me inbox:create-reply [options]

Option	Description
`--text <text>`	Reply text content
`--file <file-ids...>`	File IDs to attach (max 4 images, space-separated)

Examples

# Text-only saved reply
so-me inbox:create-reply --text "Thanks for reaching out!"

# Text with an attached file
so-me inbox:create-reply --text "Check this out" --file 7c2d4e8f-...

# Multiple file attachments
so-me inbox:create-reply --file 7c2d4e8f-... 8d3e5f9a-...

inbox:edit-reply

Edit a saved reply. At least one of --text or --file is required.

so-me inbox:edit-reply <id> [options]

string

required

Saved reply ID to update.

Option	Description
`--text <text>`	New reply text
`--file <file-ids...>`	New file IDs (replaces existing, max 4 images, space-separated)

Examples

# Update the text
so-me inbox:edit-reply 7c2d4e8f-... --text "Updated response"

# Replace the attached files
so-me inbox:edit-reply 7c2d4e8f-... --file 8d3e5f9a-... 9e4f6a0b-...

inbox:delete-reply

Delete one or more saved replies. Prompts for confirmation unless --yes is passed. Each reply is deleted individually, and partial failures are reported.

so-me inbox:delete-reply <ids...> [options]

string[]

required

One or more saved reply IDs to delete (space-separated).

Option	Description
`-y, --yes`	Skip the confirmation prompt

Examples

# Delete a single saved reply (prompts to confirm)
so-me inbox:delete-reply 7c2d4e8f-...

# Delete several without confirmation
so-me inbox:delete-reply 7c2d4e8f-... 8d3e5f9a-... --yes

# Delete every saved reply
so-me inbox:saved-replies \
  | jq -r '.[].id' \
  | xargs so-me inbox:delete-reply --yes

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

Conversations

inbox:list

inbox:messages

inbox:read

inbox:resolve

inbox:delete

Replies

inbox:reply

Subscriptions

inbox:subscribe

inbox:unsubscribe

inbox:enable

inbox:disable

Saved Replies

inbox:saved-replies

inbox:create-reply

inbox:edit-reply

inbox:delete-reply

​Conversations

​inbox:list

​inbox:messages

​inbox:read

​inbox:resolve

​inbox:delete

​Replies

​inbox:reply

​Subscriptions

​inbox:subscribe

​inbox:unsubscribe

​inbox:enable

​inbox:disable

​Saved Replies

​inbox:saved-replies

​inbox:create-reply

​inbox:edit-reply

​inbox:delete-reply

Conversations

inbox:list

inbox:messages

inbox:read

inbox:resolve

inbox:delete

Replies

inbox:reply

Subscriptions

inbox:subscribe

inbox:unsubscribe

inbox:enable

inbox:disable

Saved Replies

inbox:saved-replies

inbox:create-reply

inbox:edit-reply

inbox:delete-reply