Manage Front (shared inbox) via CLI - conversations, inboxes, messages, contacts, tags, teammates, channels, accounts, events, comments. Use when user mentions 'front', 'frontapp', 'shared inbox', 'team inbox', 'customer email', 'support inbox', 'help@', 'reply to customer', 'check front', 'front conversations', or wants to read/send/manage customer communications.
Front shared inbox CLI. Read conversations, reply to customers, manage contacts, and monitor team activity.
bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle frontapp
npx api2cli link frontapp
Always use --json flag when calling commands programmatically.
frontapp-cli auth set "your-front-api-token"
frontapp-cli auth test
Important: Front uses company-specific API URLs (e.g., companyname.api.frontapp.com). The base URL is configured in src/lib/config.ts.
conversations list --status openconversations get <id> + messages list <id>messages reply <cnv-id> --body "..."messages send <channel-id> --to email --body "..."comments create <cnv-id> --body "..."contacts list or contacts get <id>teammates listchannels list# Get open conversations
frontapp-cli conversations list --status open --json
# Read a specific conversation
frontapp-cli messages list cnv_abc123 --json
# Reply
frontapp-cli messages reply cnv_abc123 --body "Thanks for reaching out..." --json
# Archive
frontapp-cli conversations update cnv_abc123 --status archived --json
# Find the right channel (email address to send from)
frontapp-cli channels list --json
# Send from that channel
frontapp-cli messages send cha_xyz --to [email protected] --subject "Hello" --body "<p>Your message</p>" --json
# Recent conversations
frontapp-cli conversations list --limit 10 --json
# Activity timeline for a conversation
frontapp-cli events list cnv_abc123 --json
| Command | Description |
|---|---|
conversations list [--status open|archived] [--limit N] | List conversations |
conversations get <id> | Get conversation details |
conversations update <id> --status archived | Archive conversation |
conversations update <id> --assignee [email protected] | Assign to teammate |
conversations update <id> --assignee none | Unassign |
conversations update <id> --tags billing,urgent | Set tags |
| Command | Description |
|---|---|
inboxes list | List all inboxes |
inboxes get <id> | Get inbox details |
inboxes conversations <id> [--status open] | List conversations in inbox |
| Command | Description |
|---|---|
messages list <cnv-id> [--limit N] | List messages in conversation |
messages send <channel-id> --to email --body "text" | Send new message |
messages send <channel-id> --to [email protected] --subject "Hi" --body "<p>HTML</p>" | Send with subject + HTML |
messages reply <cnv-id> --body "text" | Reply to conversation |
messages reply <cnv-id> --body "note" --type note | Add internal note via reply |
| Command | Description |
|---|---|
contacts list [--limit N] | List contacts |
contacts get <id> | Get contact details |
contacts create --name "Name" --email email | Create contact |
contacts create --name "Name" --email email --phone "+1234" | Create with phone |
| Command | Description |
|---|---|
tags list | List all tags |
| Command | Description |
|---|---|
teammates list | List team members |
teammates get <id> | Get teammate details |
| Command | Description |
|---|---|
channels list | List all channels (email/SMS addresses) |
channels get <id> | Get channel details |
| Command | Description |
|---|---|
accounts list | List connected accounts |
accounts get <id> | Get account details |
| Command | Description |
|---|---|
events list <cnv-id> | Activity timeline for a conversation |
| Command | Description |
|---|---|
comments list <cnv-id> | List internal notes |
comments create <cnv-id> --body "text" | Add internal note |
All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header, --fields <cols>, --limit N, --page-token <token>
With --json, responses return: { "_results": [...], "_pagination": { "next": "..." } }
Front uses _results (not data) for list responses. Pagination via _pagination.next URL or --page-token.