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 |
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
errorresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey |
string | yes | — | DEPRECATED — bind an API Key credential to the task with credentialName instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change. |
operation |
string | yes | — | One of: list-inboxes, list-conversations, get-conversation, search-conversations, add-comment |
inboxId |
string | no | — | Inbox ID (e.g. inb_xxxx) — used by list-conversations |
conversationId |
string | no | — | Conversation ID (e.g. cnv_xxxx) — used by get-conversation and add-comment |
query |
string | no | — | Search query string — used by search-conversations |
comment |
string | no | — | Text of the comment to add — used by add-comment |
limit |
string | no | 25 |
Maximum number of results to return (default 25, max 100) |