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

# Front

> Connect Front to your Atako agents — 12 read and 5 write actions.

Let your agents manage conversations, contacts, teammates and tags in your Front shared inbox.

## Connection

* **Authentication**: API key (API token).

<Note>
  Front → Settings → Developers → API Tokens tab → Create API token. Name it, choose the resources it may access (the shared workspaces whose inboxes and tags the agents need; private resources only if required) and keep write permission off unless agents must reply, comment or update contacts. Copy the token: Front shows it only once.

  See [Front's documentation](https://dev.frontapp.com/docs/create-and-revoke-api-tokens).
</Note>

## Read actions (12)

| Action                       | Description                                                                                                                                                                                                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_contact`                | Fetch a single contact by its id.                                                                                                                                                                                     |
| `get_conversation`           | Fetch a single conversation by its id.                                                                                                                                                                                |
| `get_inbox`                  | Fetch a single inbox by its id.                                                                                                                                                                                       |
| `get_me`                     | Fetch the identity of the current API token (company name and id).                                                                                                                                                    |
| `get_message`                | Fetch a single message by its id.                                                                                                                                                                                     |
| `list_contacts`              | List contacts in the company, cursor-paginated.                                                                                                                                                                       |
| `list_conversation_comments` | List internal comments (notes) on a conversation in reverse chronological order.                                                                                                                                      |
| `list_conversation_messages` | List messages in a conversation in reverse chronological order.                                                                                                                                                       |
| `list_conversations`         | List conversations in reverse chronological order. Pass a q parameter as a JSON object to filter by statuses (e.g. \{"statuses":\["assigned","unassigned"]}). Status values: assigned, unassigned, archived, deleted. |
| `list_inboxes`               | List all inboxes the token has access to.                                                                                                                                                                             |
| `list_tags`                  | List all tags the token has access to.                                                                                                                                                                                |
| `list_teammates`             | List all teammates in the company.                                                                                                                                                                                    |

## Write actions (5)

| Action                        | Description                                                                                                                                                                                                                                                                                 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_contact`              | Create a new contact. handles is required: array of objects with handle (string, e-mail address) and source (string enum: email, phone, twitter, facebook, intercom, front\_chat, custom). Optional: name (string), description (string), list\_names (array of contact list name strings). |
| `create_conversation_comment` | Add an internal comment (note) to a conversation. body is required (string, markdown allowed). Optional: author\_id (teammate id string).                                                                                                                                                   |
| `reply_to_conversation`       | Reply to a conversation by sending a message. body is required (string, plain text or HTML). Optional: subject (string, email only), author\_id (teammate id string), channel\_id (string), to/cc/bcc (arrays of email handle strings).                                                     |
| `update_contact`              | Update a contact. Optional: name (string), description (string), list\_names (array of contact list name strings, replaces all existing lists).                                                                                                                                             |
| `update_conversation`         | Update a conversation. Set status (archived, open, deleted, spam), assignee\_id (teammate id string, or null to unassign), or tag\_ids (array of tag id strings, replaces existing tags). Only one of status or status\_id should be provided.                                              |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.