Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.
VariableRequiredDescription
FRONT_API_TOKENYesFront API token, created under Settings → Developers → API Tokens (sent as Authorization: Bearer) Docs.

Setup

  1. Get a Front account: Sign up at https://front.com - a free trial workspace is enough for testing. You can also request a developer sandbox at https://dev.frontapp.com.
  2. Create an API token: In Front, open Settings → Developers → API Tokens and click ‘Create API token’. Give it a descriptive name and pick the scopes you need (read access for browsing, plus shared resource access to send replies). Admin privileges are required to manage tokens.
  3. Store the token: Add FRONT_API_TOKEN=<your token> to your .env file. Requests authenticate with the header ‘Authorization: Bearer <token>’ against https://api2.frontapp.com.
  4. Verify access: Run the List Inboxes tool. You should get back the inboxes your token’s scopes can see.
  • Replying to a conversation archives it by default - pass options { “archive”: false } to keep it open
  • Message sending is asynchronous: the reply endpoint returns 202 Accepted with a message_uid rather than the final message
  • API tokens are scoped at creation time; a token without the messaging scopes can read conversations but not send replies
Provider API reference: https://dev.frontapp.com/reference/introduction

Tools

ToolAccessDescription
List ConversationsReadList conversations across your Front inboxes, most recently updated first
Get ConversationReadRetrieve a single conversation with its subject, status, assignee, recipient, and tags
List Conversation MessagesReadList the messages in a conversation thread, including bodies and authors
Reply to ConversationWriteSend a reply message in an existing conversation (archives the conversation by default)
Update ConversationWriteUpdate a conversation’s assignee, status, inbox, or tags, e.g. to assign, archive, or reopen it without sending a message
Search ConversationsReadFull-text search across conversations with operators like from:, tag:, inbox:, is:open, before:/after:
List TeammatesReadList the teammates in the company to find teammate IDs for assignment and reply authorship
List InboxesReadList the shared inboxes in the company to find inbox IDs and names

Example prompts

  • List the open conversations in my Front inboxes and summarize who is waiting on a reply.
  • Read the messages in a Front conversation I specify and draft a concise, friendly reply that resolves the request.
  • List my Front inboxes and give me a quick overview of conversation volume and status per inbox.