> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-e6644908.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations for the agent and automations

> Connect third-party apps so the Mintlify agent can use live context in Slack, during automation runs, or as a trigger for custom automations.

Integrations connect the Mintlify agent to other tools your team uses. The agent can use connected apps while responding in Slack or running an automation. Events from some shared integrations can also start a custom automation.

| Integration use        | What it does                                                                                                      |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Slack agent**        | Uses shared integrations and the personal integrations of the teammate who is chatting with the agent as context. |
| **Automation tool**    | Gives an automation read-only context from the shared integrations selected in its **Tools** setting.             |
| **Automation trigger** | Starts a custom automation when a selected event occurs in a supported shared integration.                        |

<Note>
  The [Mintlify Slack app](/agent/slack) is separate from the integrations on this page. Installing the Slack app adds the agent to your workspace and gives the agent and automation runs access to Slack content that the app can read. You do not connect Slack from the **Integrations** settings page or select it in an automation's **Tools** field.
</Note>

## Connection scope

Integrations have one of two connection scopes.

* **Shared integrations** connect once for your organization. The Slack agent can use them, and you can add them as tools to supported automations. Shared integrations that provide events can also trigger custom automations.
* **Personal integrations** connect separately for each teammate. The Slack agent uses the personal account of the teammate who is chatting with it. Automations cannot use personal integrations as tools or triggers.

For example, if two teammates connect separate Google Drive accounts, each sees results from their own Drive when asking the agent a question in Slack.

There is no limit to how many teammates can connect their own accounts. In a Slack thread with multiple participants, the agent uses the personal integrations of each message's sender.

## Connect an integration

Admins and editors can connect shared integrations on behalf of the organization. Each teammate connects their own personal integrations.

### From the dashboard

1. Go to the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings.
2. Find the integration you want to connect.
3. Click **Connect**.
4. Follow the authorization prompts.

You can also connect an integration while configuring an automation. Select an unconnected app in the automation's **Tools** field, then complete the authorization flow.

### From the Slack agent

Prompt the agent to connect an app, such as "Connect Google Drive." The agent returns an authorization link in the Slack thread. Complete the authorization, then send another message in the same thread so the agent can confirm and use the connection.

## Supported integrations

The dashboard shows the integrations currently available to your organization.

| Integration  | Scope    | Available as an automation trigger |
| ------------ | -------- | ---------------------------------- |
| Confluence   | Shared   | Yes                                |
| Contentful   | Shared   | No                                 |
| Excel        | Personal | No                                 |
| Figma        | Shared   | No                                 |
| Gmail        | Personal | No                                 |
| Google Drive | Personal | No                                 |
| HubSpot      | Shared   | No                                 |
| Intercom     | Shared   | No                                 |
| Jira         | Shared   | Yes                                |
| Linear       | Shared   | Yes                                |
| Notion       | Shared   | Yes                                |
| OneDrive     | Personal | No                                 |
| OneNote      | Personal | No                                 |
| Outlook      | Personal | No                                 |
| Plain        | Shared   | No                                 |
| Salesforce   | Shared   | No                                 |
| Zendesk      | Shared   | Yes                                |

## Use integrations with the Slack agent

After you install the [Mintlify Slack app](/agent/slack), the agent can use integrations while answering questions or updating your documentation. You do not have to select integrations for each Slack conversation.

The agent can use:

* Shared integrations connected to your organization.
* Personal integrations connected by the teammate who sent the request.
* Slack channels and threads that the installed Mintlify app has permission to read.

For example, ask the agent to compare a Linear issue with a Google Drive product brief, answer a question using a Notion page, or update documentation using context from a Jira issue.

The agent only accesses integration data when it is relevant to the request.

## Use integrations as automation tools

Automation tools give the agent additional context after an automation starts. You can select only shared integrations.

1. Open the automation's settings.
2. In **Tools**, select the integrations that the automation can use.
3. Connect any selected integration that is not already connected.
4. Save the automation.

If an integration is an automation trigger, it is always a tool for that automation. This lets the agent retrieve additional details after it receives the event that started the run.

## Trigger an automation from an integration

Custom automations can run when an event occurs in a supported shared integration.

1. Create or open a custom automation.
2. For **Trigger**, select **Integration**.
3. Select or connect a shared integration.
4. Select the **Trigger event**.
5. Complete any additional event fields that appear.
6. Save and turn on the automation.

The supported events depend on the integration:

| Integration | Events                                                               |
| ----------- | -------------------------------------------------------------------- |
| Confluence  | Page created; content added to a space                               |
| Jira        | Issue created; issue updated; project created                        |
| Linear      | Issue created; issue updated; project created; project update posted |
| Notion      | Page created; page content updated                                   |
| Zendesk     | Ticket created                                                       |

When the event occurs, Mintlify starts the automation and includes the event payload as context for the agent. Duplicate deliveries of the same event do not start duplicate runs.

## Permissions and access

The agent has read-only access through third-party integration tools. It can search and retrieve content, but it cannot use these tools to create, edit, or delete data in the connected app.

The agent inherits the access of the account that authorized the connection:

* For a shared integration, it can read content available to the connected workspace account.
* For a personal integration, it can read content available to the teammate who connected it.
* For Slack, it can read public and private channels that include the Mintlify app.

Authorization providers may group permissions differently. Review the authorization screen for the exact permissions requested before connecting an app. To narrow access, restrict the authorizing account's permissions or only grant the Mintlify app access to specific resources.

If your organization restricts which apps users can authorize, ask the relevant administrator, such as your Google Workspace or Atlassian administrator, to approve the Mintlify app.

## Disconnect an integration

1. Go to the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings.
2. Find the connected integration and click **Configure**.
3. Click **Disable integration**.

Disconnecting a shared integration removes it for everyone in your organization. Automations can no longer use it as a tool, and custom automations configured to use it as a trigger stop receiving new events.

Disconnecting a personal integration only removes your connection. Other teammates keep their personal connections.

## Troubleshoot a connection

If an integration stops working:

1. Confirm that the authorizing account can still access the relevant content.
2. Open the integration's **Configure** dialog and disable it.
3. Connect the integration again and complete the authorization flow.
4. If the connection is for the Slack agent, send another message in the original Slack thread.

If an administrator blocks authorization, ask your app or workspace administrator to approve Mintlify. The authorization screen shows the app identity and permissions that require approval.