Front
Manage shared inboxes, conversations, and comments in Front — a customer communication platform that unifies email, SMS, and other channels into collaborative shared inboxes.
Operations
| Operation | What it does | Required inputs |
|---|---|---|
list-inboxes |
List all inboxes in your Front account | — |
list-conversations |
List conversations in a specific inbox | inboxId |
get-conversation |
Fetch full details for one conversation | conversationId |
search-conversations |
Search conversations by keyword or filter | query |
add-comment |
Post an internal comment on a conversation | conversationId, comment |
API Key Setup
- Log into Front and go to Settings > API & Webhooks > Tokens
- Click Create token, give it a name, and copy the token
- Paste the token into the
apiKeyinput field
Front API tokens use Authorization: Bearer <token> against https://api2.frontapp.com.
Required scopes depend on operations used:
- Reading inboxes/conversations: conversations:read, inboxes:read
- Adding comments: comments:write
Examples
List all inboxes:
{
"apiKey": "your-token",
"operation": "list-inboxes"
}
List the 10 most recent conversations in an inbox:
{
"apiKey": "your-token",
"operation": "list-conversations",
"inboxId": "inb_abc123",
"limit": "10"
}
Fetch a conversation:
{
"apiKey": "your-token",
"operation": "get-conversation",
"conversationId": "cnv_xyz789"
}
Search conversations:
{
"apiKey": "your-token",
"operation": "search-conversations",
"query": "billing refund"
}
Add an internal comment:
{
"apiKey": "your-token",
"operation": "add-comment",
"conversationId": "cnv_xyz789",
"comment": "Customer has been escalated to tier 2."
}
Output
| Field | Description |
|---|---|
result |
JSON string containing the response payload |
status |
"ok" on success |