# Front

Manage Front shared inbox: conversations, messages, comments, tags, contacts. Exposes **39 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `front_list_inboxes` | List all inboxes (shared mailboxes) - GET /inboxes. |
| `front_get_inbox` | Get one inbox by ID or alias - GET /inboxes/{inbox_id}. |
| `front_list_channels` | List channels in an inbox - GET /inboxes/{inbox_id}/channels. |
| `front_get_channel` | Get one channel by ID - GET /channels/{channel_id}. |
| `front_list_conversations` | List conversations - GET /conversations. |
| `front_get_conversation` | Get one conversation by ID - GET /conversations/{conversation_id}. |
| `front_update_conversation` | Update conversation (status, assignee) - PATCH /conversations/{conversation_id}. |
| `front_assign_conversation` | Assign or reassign a conversation - PATCH /conversations/{conversation_id}. |
| `front_list_messages` | List messages in a conversation - GET /conversations/{conversation_id}/messages. |
| `front_get_message` | Get one message by ID - GET /messages/{message_id}. |
| `front_create_message` | Create and send a message - POST /conversations/{conversation_id}/messages. |
| `front_list_comments` | List internal comments on a conversation - GET /conversations/{conversation_id}/comments. |
| `front_create_comment` | Create an internal comment (team note) - POST /conversations/{conversation_id}/comments. |
| `front_list_tags` | List all tags - GET /tags. |
| `front_create_tag` | Create a new tag - POST /tags. |
| `front_update_tag` | Update a tag - PATCH /tags/{tag_id}. |
| `front_delete_tag` | Delete a tag - DELETE /tags/{tag_id}. |
| `front_add_tag_to_conversation` | Add a tag to a conversation - POST /conversations/{conversation_id}/tags. |
| `front_remove_tag_from_conversation` | Remove a tag from a conversation - DELETE /conversations/{conversation_id}/tags/{tag_id}. |
| `front_list_contacts` | List contacts (CRM) - GET /contacts. |
| `front_get_contact` | Get one contact by ID - GET /contacts/{contact_id}. |
| `front_create_contact` | Create a contact - POST /contacts. |
| `front_update_contact` | Update a contact - PATCH /contacts/{contact_id}. |
| `front_delete_contact` | Delete a contact - DELETE /contacts/{contact_id}. |
| `front_list_drafts` | List drafts - GET /drafts. |
| `front_get_draft` | Get one draft by ID - GET /drafts/{draft_id}. |
| `front_create_draft` | Create a draft (unsent message) - POST /conversations/{conversation_id}/drafts. |
| `front_delete_draft` | Delete a draft - DELETE /drafts/{draft_id}. |
| `front_list_teammates` | List team members - GET /teammates. |
| `front_get_teammate` | Get one teammate by ID - GET /teammates/{teammate_id}. |
| `front_update_teammate` | Update a teammate role - PATCH /teammates/{teammate_id}. |
| `front_list_templates` | List reply templates - GET /templates. |
| `front_get_template` | Get one template by ID - GET /templates/{template_id}. |
| `front_list_rules` | List automation rules - GET /rules. |
| `front_list_custom_fields` | List custom fields for contacts - GET /custom_fields. |
| `front_list_knowledge_bases` | List knowledge bases - GET /knowledge_bases. |
| `front_get_knowledge_base` | Get one knowledge base by ID - GET /knowledge_bases/{knowledge_base_id}. |
| `front_list_conversation_groups` | List conversation groups (contact groups) - GET /conversation_groups. |
| `front_get_conversation_group` | Get one conversation group by ID - GET /conversation_groups/{group_id}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`FRONT_API_TOKEN`** - Front - Settings - Developers - API tokens. (https://app.frontapp.com/settings/tools/api)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `FRONT_API_TOKEN` | Front - Settings - Developers - API tokens. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Front API documentation](https://dev.frontapp.com/reference)