# Integrations

Use **Integrations** when you want Fetch Hive to connect to an external service on behalf of your workspace. Depending on the provider, the connection flow either redirects you through OAuth or asks you to paste an API key.

## Overview

The integrations page shows one card per available provider. Each card gives you a **Connect** action and an enabled or disabled state you can change after the integration is set up.

You also use **Integrations** when you choose **Personal** charge type and need to connect provider credentials.

## How do I connect an integration? <a href="#connect-integration" id="connect-integration"></a>

Open **Tools** in the sidebar, then click **Integrations**.

Find the provider you want to connect.

Click **Connect**.

If the provider uses OAuth, Fetch Hive redirects you to the provider's sign-in and approval flow.

If the provider uses a direct secret instead, Fetch Hive opens a modal asking for your API key.

Complete the OAuth flow or save the API key in the modal to finish the connection.

## How do I update a saved integration key? <a href="#update-integration-key" id="update-integration-key"></a>

Open the integration card again and choose **Connect**.

For API-key-based integrations, the same modal opens again so you can replace the saved secret with a new one.

Save the updated key to keep the integration connected with the new credential.

## How do I enable or disable an integration? <a href="#toggle-integration" id="toggle-integration"></a>

Use the switch on the integration card when you want to control whether the connected integration is enabled for the workspace.

Turn it on to enable the integration.

Turn it off to disable it without removing the card itself.

## When should I use integrations? <a href="#when-to-use-integrations" id="when-to-use-integrations"></a>

Use **Integrations** whenever Fetch Hive needs workspace-level access to an external provider.

That includes both general tool connections and provider credentials used by **Personal** charge type flows described in [Use your own API Key](/your-workspace/llm-providers.md).

## Connecting external apps (Airtable, Linear, and more)

The Integrations page lists all providers in a uniform grid — AI model providers (OpenAI, Anthropic, etc.) alongside workflow and agent tools (Slack, Gmail, Airtable, Linear, and more). There is no separate section.

### Connecting an app

Click **Connect** on any app card. Depending on the provider, Fetch Hive either:

* Shows an API key entry field directly on the card.
* Redirects you through the provider's OAuth flow. After completing the flow, the browser returns to the Integrations page and the card updates to show **Connected** with your account identifier.

### Reconnecting an expired connection

If a connection expires (shown with an amber **Expired — Reconnect** badge), click **Reconnect** to refresh the token.

### Disconnecting an app

Click **Disconnect** to remove the connection. Any workflow steps or agents that relied on this connection will fail until a new connection is established.

See also: [Use your own API Key](/your-workspace/llm-providers.md) and [API keys](/your-workspace/api-keys.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fetchhive.com/your-workspace/integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.