> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Front

> Read Front shared-inbox conversations and messages and send replies on behalf of your team

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `FRONT_API_TOKEN` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://dev.frontapp.com/docs/authentication](https://dev.frontapp.com/docs/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable          | Required | Description                                                                                                                                                           |
| ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FRONT_API_TOKEN` | Yes      | Front API token, created under Settings → Developers → API Tokens (sent as Authorization: Bearer) [Docs](https://dev.frontapp.com/docs/create-and-revoke-api-tokens). |

## Setup

1. **Get a Front account**: Sign up at [https://front.com](https://front.com) - a free trial workspace is enough for testing. You can also request a developer sandbox at [https://dev.frontapp.com](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](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](https://dev.frontapp.com/reference/introduction)

## Tools

| Tool                       | Access | Description                                                                                                               |
| -------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| List Conversations         | Read   | List conversations across your Front inboxes, most recently updated first                                                 |
| Get Conversation           | Read   | Retrieve a single conversation with its subject, status, assignee, recipient, and tags                                    |
| List Conversation Messages | Read   | List the messages in a conversation thread, including bodies and authors                                                  |
| Reply to Conversation      | Write  | Send a reply message in an existing conversation (archives the conversation by default)                                   |
| Update Conversation        | Write  | Update a conversation's assignee, status, inbox, or tags, e.g. to assign, archive, or reopen it without sending a message |
| Search Conversations       | Read   | Full-text search across conversations with operators like from:, tag:, inbox:, is:open, before:/after:                    |
| List Teammates             | Read   | List the teammates in the company to find teammate IDs for assignment and reply authorship                                |
| List Inboxes               | Read   | List 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.