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)