Manage Front conversations and inboxes from Guild agents

Integrations · Front

Guild agents read and manage Front conversations, contacts, inboxes, and knowledge bases on your team’s behalf. Credentials are stored and injected server-side, so agent code never sees the API token. Credential policies let you restrict which operations each agent can call, and every request runs through Guild’s audit trail.

Book a demo

See how teams govern agents that use Front.

Talk to sales

Get access to Guild, then connect Front to your first agent.

What the Front integration exposes

The integration is published as guildai~front-openapi and surfaces tools that cover conversations, messages, drafts, contacts, inboxes, tags, message templates, signatures, knowledge bases, analytics, shifts, time off, and teammate and team management. Tools follow the front_openapi_ naming prefix. Use pick() from the SDK to include only the tools your agent needs.

How it works

Open credentials in Guild

Go to Access & setup > Credentials in Guild and click Connect. Search for and select front-openapi.

Paste your Front API key

Paste your Front API token into the API Key field. Guild sends the key as a bearer token in the Authorization header on every request.

Scope the credential

Choose whether the credential serves the whole account, one workspace, yourself only, or a single agent. See Credentials for details on each scope.

Why Front access needs governing

Front tools can send messages, delete conversations, manage teammates, and modify inboxes. Guild stores the API token server-side and injects it through its credential proxy, so agent code never handles the secret directly. You can scope each credential to an account, workspace, member, or single agent using Credentials, limiting which workspaces and agents can reach Front at all. Credential policies let you write ALLOW and DENY rules against specific front_openapi_ operation names. A policy can permit read operations like front_openapi_list_conversations while blocking destructive ones like front_openapi_delete_conversation, and rules can be scoped to individual agents or workspaces on the same credential. Every request is checked inside the proxy before it leaves Guild; agents cannot bypass the check.

About the Front integration

Agents can read and manage Front inboxes, contacts, conversations, and tags. They can send messages, create drafts, manage message templates and signatures, and work with knowledge bases and articles. Team and teammate management tools are also available, including shifts, time off, and contact groups. The integration is guildai~front-openapi.

Authentication

Type: API key
Header: Guild sends the key as a bearer token in the Authorization header

Setup

Connect Front

In Guild, go to Access & setup > Credentials, click Connect, select front-openapi, and paste the key into API Key.

See Credentials for workspace, member, and agent-scoped credentials.

Usage

import { FrontOpenapiTools } from "@guildai-services/guildai~front-openapi"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  systemPrompt: "You work with Front.",
  tools: { ...FrontOpenapiTools },
})

Selecting specific tools

Tools are named with the front_openapi_ prefix. Use pick() to include only what your agent needs.

Tools

Tools in the latest published version of guildai~front-openapi:

All 225 tools

Tool	What it does
`front_openapi_add_comment_reply`	Add a reply to a comment on a conversation.
`front_openapi_add_company_teammate_group_team_inboxes`	Links non-public inboxes to the teammate group.
`front_openapi_add_company_teammate_group_teammates`	Add teammate group teammates.
`front_openapi_add_company_teammate_group_teams`	Adds teams to the teammate group.
`front_openapi_add_contact_handle`	Adds a new handle to a contact.
`front_openapi_add_contacts_to_contact_list`	Add contacts to the requested contact list.
`front_openapi_add_contacts_to_group`	Add contacts to the requested group.
`front_openapi_add_contact_to_account`	Adds a list of contacts to an Account
`front_openapi_add_inbox_access`	Give access to one or more teammates to an inbox.
`front_openapi_add_note`	Create a new note on a contact.
`front_openapi_add_teammates_to_shift`	Add teammates to a shift.
`front_openapi_add_teammates_to_team`	Add one or more teammates to a team (workspace).
`front_openapi_add_view_teammates`	Makes this view visible in specified teammates’ sidebar navigation.
`front_openapi_api_token_details`	Fetch the details of the API token.
`front_openapi_create_account`	Create a new account.
`front_openapi_create_a_channel`	Create a channel in an inbox.
`front_openapi_create_a_knowledge_base`	Creates a knowledge base.
`front_openapi_create_analytics_export`	Create a new analytics export of messages or events (activities) over a specific time span.
`front_openapi_create_analytics_report`	Create a new analytics report for a set of metrics over a specific time span.
`front_openapi_create_article_in_a_knowledge_base_in_default_locale`	Creates an article in a knowledge base in the default locale.
`front_openapi_create_article_in_a_knowledge_base_in_specified_locale`	Create an article for a given locale in a knowledge base.
`front_openapi_create_child_folder`	Create a new message template folder as a child of the given folder
`front_openapi_create_child_tag`	Creates a child tag.
`front_openapi_create_child_template`	Create a new message template as a child of the given folder
`front_openapi_create_company_tag`	Create a company tag.
`front_openapi_create_company_teammate_group`	Create a new teammate group.
`front_openapi_create_contact`	Create a new contact at the company level.
`front_openapi_create_contact_list`	Create a new contact list in the oldest active workspace that the token has access to.
`front_openapi_create_conversation`	Create a new conversation of type discussion or task.
`front_openapi_create_draft`	Create a draft message which is the first message of a new conversation.
`front_openapi_create_folder`	Create a new message template folder in the oldest active workspace that the token has access to.
`front_openapi_create_group`	Create a new contact group in the default team (workspace).
`front_openapi_create_inbox`	Create an inbox in the oldest active workspace that the token has access to.
`front_openapi_create_knowledge_base_category_in_default_locale`	Creates a knowledge base category in the default locale.
`front_openapi_create_knowledge_base_category_in_specified_locale`	Creates a knowledge base category for a given locale.
`front_openapi_create_link`	Create a link.
`front_openapi_create_message`	Send a new message from a channel.
`front_openapi_create_message_template`	Create a new message template in the oldest active workspace that the token has access to.
`front_openapi_create_shift`	Create a shift in the oldest active workspace that the token has access to.
`front_openapi_create_tag`	Create a tag in the oldest team (workspace).
`front_openapi_create_team_contact`	Create a contact for a team (workspace).
`front_openapi_create_team_contact_list`	Create a new contact list for the requested team (workspace).
`front_openapi_create_team_folder`	Create a new message template folder belonging to the requested team (workspace).
`front_openapi_create_team_group`	Create a new contact group for the requested team (workspace).
`front_openapi_create_team_inbox`	Create an inbox for a team (workspace).
`front_openapi_create_teammate_contact`	Create a contact for a teammate.
`front_openapi_create_teammate_contact_list`	Create a new contact list for the requested teammate.
`front_openapi_create_teammate_folder`	Create a new message template folder belonging to the requested teammate.
`front_openapi_create_teammate_group`	Create a new contact group for the requested teammate.
`front_openapi_create_teammate_message_template`	Create a new message template for the given teammate
`front_openapi_create_teammate_private_inbox`	Create a private inbox for a teammate.
`front_openapi_create_teammate_signature`	Create a new signature for the given teammate
`front_openapi_create_teammate_tag`	Create a tag for a teammate.
`front_openapi_create_team_message_template`	Create a new message template for the given team (workspace).
`front_openapi_create_team_shift`	Create a shift for a team (workspace).
`front_openapi_create_team_signature`	Create a new signature for the given team (workspace).
`front_openapi_create_team_tag`	Create a tag for a team (workspace).
`front_openapi_create_team_view`	Create a new view for a team.
`front_openapi_create_time_off`	Create a time off for a teammate.
`front_openapi_delete_a_contact`	Delete a contact.
`front_openapi_delete_a_knowledge_base_category`	Deletes a knowledge base category.
`front_openapi_delete_an_account`	Deletes an account
`front_openapi_delete_an_article`	Deletes an article and all its content and translations.
`front_openapi_delete_company_teammate_group`	Deletes a teammate group.
`front_openapi_delete_contact_handle`	Remove a handle from a contact.
`front_openapi_delete_contact_list`	Delete a contact lists.
`front_openapi_delete_conversation`	Permanently delete a conversation.
`front_openapi_delete_draft`	Delete a draft message.
`front_openapi_delete_folder`	Delete a message template folder and child folders/templates
`front_openapi_delete_group`	Delete a contact group.
`front_openapi_delete_message_template`	Delete a message template
`front_openapi_delete_signature`	Delete signature
`front_openapi_delete_tag`	Delete a tag.
`front_openapi_delete_time_off`	Delete a time off.
`front_openapi_download_attachment`	Download an attachment file.
`front_openapi_download_attachment_for_a_comment`	Download an attachment file for a given comment ID
`front_openapi_download_attachment_for_a_message`	Download an attachment file for a given message id.
`front_openapi_download_attachment_for_a_message_template`	Download an attachment file for a given message template ID
`front_openapi_download_attachment_from_an_article`	Downloads the attachment from an article.
`front_openapi_edit_draft`	Edit a draft message.
`front_openapi_fetch_an_account`	Fetches an account
`front_openapi_get_a_knowledge_base`	Fetches a knowledge base.
`front_openapi_get_a_knowledge_base_article`	Fetches a knowledge base article.
`front_openapi_get_a_knowledge_base_category`	Fetches a knowledge base category.
`front_openapi_get_a_knowledge_base_with_content_in_default_locale`	Fetches a knowledge base with its content in the default locale.
`front_openapi_get_a_knowledge_base_with_content_in_specified_locale`	Fetches a knowledge base with its content for a given locale.
`front_openapi_get_analytics_export`	Fetch an analytics exports.
`front_openapi_get_analytics_report`	Fetch an analytics report.
`front_openapi_get_channel`	Fetch a channel.
`front_openapi_get_child_folders`	Fetch the child message templates folders of a message template folder.
`front_openapi_get_child_templates`	Fetch the child message templates of a message template folder.
`front_openapi_get_comment`	Fetches a comment.
`front_openapi_get_company_teammate_group`	Fetch a teammate group.
`front_openapi_get_contact`	Fetch a contact.
`front_openapi_get_event`	Fetch an event.
`front_openapi_get_folder`	Fetch a message template folder.
`front_openapi_get_inbox`	Fetch an inbox.
`front_openapi_get_knowledge_base_article_with_content_in_default_locale`	Fetches a knowledge base article with content in the default locale.
`front_openapi_get_knowledge_base_article_with_content_in_specified_locale`	Fetches a knowledge base article with content for a given locale.
`front_openapi_get_knowledge_base_category_content_in_default_locale`	Fetches a knowledge base category with content in the default locale.
`front_openapi_get_knowledge_base_category_with_content_in_specified_locale`	Fetches a knowledge base category with content for a given locale.
`front_openapi_get_link`	Fetch a link.
`front_openapi_get_message`	Fetch a message.
`front_openapi_get_message_seen_status`	Get the seen receipts for the given message.
`front_openapi_get_message_template`	Fetch a message template.
`front_openapi_get_rule`	Fetch a rule.
`front_openapi_get_shift`	Fetch a shift.
`front_openapi_get_signatures`	Get the given signature.
`front_openapi_get_tag`	Fetch a tag.
`front_openapi_get_team`	Fetch a team (workspace).
`front_openapi_get_teammate`	Fetch a teammate.
`front_openapi_get_ticket_status_by_id`	Fetch a ticket status.
`front_openapi_get_time_off`	Fetch a time off.
`front_openapi_get_view`	Fetch a view.
`front_openapi_import_inbox_message`	Use this endpoint to import conversations into Front without sending data through a channel.
`front_openapi_list_account_contacts`	Lists the contacts associated with an Account
`front_openapi_list_account_custom_fields`	Lists the custom fields that can be attached to an Account.
`front_openapi_list_accounts`	List the accounts of the company.
`front_openapi_list_all_company_rules`	List the company rules.
`front_openapi_list_articles_in_a_category`	List articles in a category.
`front_openapi_list_articles_in_a_knowledge_base`	List articles in a knowledge base
`front_openapi_list_assigned_conversations`	List the conversations assigned to a teammate in reverse chronological order (most recently updated first).
`front_openapi_list_categories_in_a_knowledge_base`	List categories in a knowledge base.
`front_openapi_list_channels`	List the channels of the company.
`front_openapi_list_comment_mentions`	List the teammates mentioned in a comment.
`front_openapi_list_company_tags`	List the company tags.
`front_openapi_list_company_teammate_groups`	List the teammate groups in the company.
`front_openapi_list_company_teammate_group_team_inboxes`	List inboxes that the teammate group has access to via its associated teams.
`front_openapi_list_company_teammate_group_teammates`	List teammate group teammates.
`front_openapi_list_company_teammate_group_teams`	List teams added to the teammate group.
`front_openapi_list_company_ticket_statuses`	List the ticket statuses available for your company.
`front_openapi_list_contact_conversations`	List the conversations for a contact in reverse chronological order (newest first).
`front_openapi_list_contact_custom_fields`	Lists the custom fields that can be attached to a Contact.
`front_openapi_list_contact_lists`	List contact lists.
`front_openapi_list_contacts`	List the contacts of the company.
`front_openapi_list_contacts_in_contact_list`	List the contacts belonging to the requested contact list.
`front_openapi_list_contacts_in_group`	List the contacts belonging to the requested group.
`front_openapi_list_conversation_custom_fields`	Lists customer-managed custom fields that can be attached to a Conversation.
`front_openapi_list_conversations`	List the conversations in the company in reverse chronological order (most recently updated first).
`front_openapi_list_custom_fields`	Lists the custom fields that can be attached to a Contact.
`front_openapi_list_events`	Lists all the detailed events which occurred in the inboxes of the company ordered in reverse chronological order (newest first).
`front_openapi_list_folders`	List the message template folders.
`front_openapi_list_groups`	List the contact groups.
`front_openapi_list_inbox_access`	List the teammates with access to an inbox.
`front_openapi_list_inbox_channels`	List the channels in an inbox.
`front_openapi_list_inbox_conversations`	List the conversations in an inbox.
`front_openapi_list_inbox_custom_fields`	Lists the custom fields that can be attached to an Inbox.
`front_openapi_list_inboxes`	List the inboxes of the company.
`front_openapi_list_knowledge_bases`	List the knowledge bases of the company.
`front_openapi_list_link_conversations`	List the conversations linked to a specific link.
`front_openapi_list_link_custom_fields`	Lists the custom fields that can be attached to a Link.
`front_openapi_list_links`	List the links of the company paginated by id.
`front_openapi_list_message_templates`	List the message templates.
`front_openapi_list_notes`	List the notes added to a contact.
`front_openapi_list_rules`	List the rules of the company.
`front_openapi_list_shifts`	List the shifts.
`front_openapi_list_shifts_teammates`	List the teammates assigned to a shift.
`front_openapi_list_tag_children`	List the children of a specific tag.
`front_openapi_list_tagged_conversations`	List the conversations tagged with a tag.
`front_openapi_list_tags`	List all the tags of the company that the API token has access to, whether they be company tags, team tags, or teammate tags.
`front_openapi_list_team_channels`	List the channels of a team (workspace).
`front_openapi_list_team_contact_lists`	List contact lists belonging to the requested team (workspace).
`front_openapi_list_team_contacts`	List the contacts of a team (workspace).
`front_openapi_list_team_folders`	List the message template folders belonging to the requested team (workspace).
`front_openapi_list_team_groups`	List contact groups belonging to the requested team (workspace).
`front_openapi_list_team_inboxes`	List the inboxes belonging to a team (workspace).
`front_openapi_list_teammate_channels`	List the channels of a teammate.
`front_openapi_list_teammate_contact_lists`	List the contact lists belonging to the requested teammate.
`front_openapi_list_teammate_contacts`	List the contacts of a teammate.
`front_openapi_list_teammate_custom_fields`	Lists the custom fields that can be attached to a Teammate.
`front_openapi_list_teammate_folders`	List the message template folders belonging to the requested teammate.
`front_openapi_list_teammate_groups`	List the contact groups belonging to the requested teammate.
`front_openapi_list_teammate_inboxes`	Returns list of inboxes the teammate has access to.
`front_openapi_list_teammate_message_templates`	List the message templates belonging to the requested teammate.
`front_openapi_list_teammate_private_inboxes`	List the private inboxes of a teammate.
`front_openapi_list_teammate_rules`	List the rules of a teammate.
`front_openapi_list_teammates`	List the teammates in the company.
`front_openapi_list_teammate_shifts`	Lists all the shifts for the teammate.
`front_openapi_list_teammate_signatures`	List the signatures belonging to the given teammate.
`front_openapi_list_teammate_tags`	List the tags for a teammate.
`front_openapi_list_teammate_time_offs`	List the time offs of a teammate.
`front_openapi_list_team_message_templates`	List the message templates belonging to the requested team (workspace).
`front_openapi_list_team_rules`	List the rules of a team (workspace).
`front_openapi_list_teams`	List the teams (workspaces) in the company.
`front_openapi_list_team_shifts`	List the shifts for a team (workspace).
`front_openapi_list_team_signatures`	List the signatures belonging to the given team (workspace).
`front_openapi_list_team_tags`	List the tags for a team (workspace).
`front_openapi_list_team_time_offs`	List the time offs of all teammates in a team.
`front_openapi_list_team_views`	List the views of a team.
`front_openapi_list_views`	List the views accessible to the authenticated token.
`front_openapi_mark_message_seen`	Mark an outbound message from Front as seen.
`front_openapi_merge_contacts`	Merges the contacts specified into a single contact, deleting the merged-in contacts.
`front_openapi_receive_custom_messages`	Receive a custom message in Front.
`front_openapi_remove_company_teammate_group_team_inboxes`	Unlinks non-public inboxes from the teammate group.
`front_openapi_remove_company_teammate_group_teammates`	Remove teammate group teammates.
`front_openapi_remove_company_teammate_group_teams`	Remove teams from the teammate group.
`front_openapi_remove_contact_from_account`	Removes a list of contacts from an Account
`front_openapi_remove_contacts_from_contact_list`	Remove contacts from the requested contact list.
`front_openapi_remove_contacts_from_group`	Remove contacts from the requested group.
`front_openapi_removes_inbox_access`	Remove access of one or more teammates from an inbox.
`front_openapi_remove_teammates_from_shift`	Remove teammates from a shift.
`front_openapi_remove_teammates_from_team`	Remove one or more teammates from a team (workspace).
`front_openapi_search_conversations`	Search for conversations.
`front_openapi_trigger_app_event`	Triggers an event on behalf of an application.
`front_openapi_update_account`	Updates an account.
`front_openapi_update_a_company_teammate_group`	Updates a teammate group.
`front_openapi_update_a_contact`	Updates a contact.
`front_openapi_update_a_link`	Update a link.
`front_openapi_update_article_content_in_default_locale`	Updates an article’s content in the default locale
`front_openapi_update_article_content_in_specified_locale`	Updates an article’s content for a given locale.
`front_openapi_update_a_tag`	Update a tag.
`front_openapi_update_channel`	Update a channel.
`front_openapi_update_comment`	Update a comment in a conversation.
`front_openapi_update_folder`	Update message template folder
`front_openapi_update_knowledge_base_category_in_default_locale`	Updates a knowledge base category in the default locale.
`front_openapi_update_knowledge_base_category_in_specified_locale`	Updates a knowledge base category for a given locale.
`front_openapi_update_knowledge_base_in_default_locale`	Updates a knowledge base in the default locale.
`front_openapi_update_knowledge_base_in_specified_locale`	Updates a knowledge base for a given locale.
`front_openapi_update_message_template`	Update a message template.
`front_openapi_update_shift`	Update a shift.
`front_openapi_update_signature`	Update signature
`front_openapi_update_teammate`	Update a teammate.
`front_openapi_update_time_off`	Update a time off.
`front_openapi_update_view`	Update a view.
`front_openapi_validate_channel`	Asynchronously validate an SMTP channel (this endpoint is irrelevant to other channel types).

Frequently asked questions

Can my agent send a message from a Front channel?

Yes. The front_openapi_create_message tool sends a new message from a channel, and front_openapi_create_draft creates a draft as the first message of a new conversation.

Does the integration support webhook events from Front?

No. The catalog entry for guildai~front-openapi lists no webhook events, so the integration does not receive inbound event triggers from Front.

How do I stop one agent from deleting conversations while letting another read them?

Write a DENY rule targeting front_openapi_delete_conversation scoped to the agent that should not delete, and an ALLOW rule for read operations. Guild’s credential proxy enforces the rules before any request reaches Front. See Credential policies for rule syntax.

Can I use the integration to manage knowledge base articles in multiple languages?

Yes. The tools include front_openapi_create_article_in_a_knowledge_base_in_specified_locale and front_openapi_get_knowledge_base_article_with_content_in_specified_locale, which create and fetch articles for a given locale alongside the default-locale equivalents.

Put a governed agent on Front this week

Book a demo

See how teams govern agents that use Front.

Talk to sales

Get access to Guild, then connect Front to your first agent.

Also runs on Guild: Intercom · Pylon · Zendesk Read: Docs: Credential policies · Credentials · Tools in agents

Overview

Code & CI/CD

Communication

Customer support

Data

Design

Inference providers

Models

Monitoring & observability

Productivity

Project management

Recruiting

Sales & finance

Testing

Web & search

Manage Front conversations and inboxes from Guild agents

Book a demo

Talk to sales

What the Front integration exposes

How it works

Why Front access needs governing

About the Front integration

Authentication

Setup

Usage

Selecting specific tools

Tools

Frequently asked questions

Put a governed agent on Front this week

Book a demo

Talk to sales

Book a demo

Talk to sales

​What the Front integration exposes

​How it works

​Why Front access needs governing

​About the Front integration

​Authentication

​Setup

​Usage

​Selecting specific tools

​Tools

​Frequently asked questions

​Put a governed agent on Front this week

Book a demo

Talk to sales

​Related

What the Front integration exposes

How it works

Why Front access needs governing

About the Front integration

Authentication

Setup

Usage

Selecting specific tools

Tools

Frequently asked questions

Put a governed agent on Front this week

Related