InTouch Hub · Blue Isle Software

Front

Manage shared inboxes, conversations, and comments in Front — the customer communication platform built for teams.

Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

billingemaillogsearchstatussupport-helpdesk

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

  1. Log into Front and go to Settings > API & Webhooks > Tokens
  2. Click Create token, give it a name, and copy the token
  3. Paste the token into the apiKey input 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.

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)