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

# Integrations Overview

> Connect Adapt to your business tools and data sources

Adapt connects to thousands of tools: anything with an API or an MCP server,
plus native one-click connectors for the most common ones. The more tools you
connect, the more your agents can see and do.

## The integrations catalog

Every available integration lives in a single catalog under
**Settings → Integrations**. Browse by category, search by name, or jump
straight to anything your organization has already connected.

![Settings → Integrations catalog with the Connected view selected, showing connected integrations as tiles](https://mintcdn.com/adapt-fa4ae803/lVRVwua4eYnKPM6T/images/integrations/catalog/catalog-page.png?fit=max\&auto=format\&n=lVRVwua4eYnKPM6T\&q=85\&s=c211eb7cf57f0d497c92210ca5a28c6c)

Each integration uses one of two connection types, which you'll see noted on
its detail page:

* **OAuth** — sign in with your account; Adapt manages the credentials for you.
  Used by Slack, GitHub, Google Workspace, Notion, Linear, HubSpot, and others.
* **API key** — paste a key, token, or connection string from the provider's
  settings. Used by Postgres, Snowflake, Stripe, Sentry, and most other
  developer-focused tools.

### Sidebar at a glance

The left sidebar lets you:

* **Search** every integration by name
* Filter to **Connected** to see only what your organization has wired up
* Filter to **Custom** to add your own integration (see [Custom integrations](#custom-integrations) below)
* Filter to **Popular** to see the most-used integrations
* Browse by category: CRM & Sales, E-commerce, Marketing & Analytics,
  Payments, Communication, Monitoring, Cloud & Dev Tools, Databases, AI & ML

Each row shows a count, so you can see at a glance what's available.

## Connecting an integration

Click any integration tile to open its detail page. The detail page shows the
provider's category, connection type, and any active connections in your
organization.

![Integration detail page with no connections yet and an Add button](https://mintcdn.com/adapt-fa4ae803/lVRVwua4eYnKPM6T/images/integrations/catalog/provider-detail-empty.png?fit=max\&auto=format\&n=lVRVwua4eYnKPM6T\&q=85\&s=bcb1412538caf627ef12c63c0df723f0)

From here, click **Add** to start a new connection. The flow that opens depends
on the connection type — OAuth or API key.

> [tab] OAuth (example: Slack)
>
> For OAuth integrations like **Slack**, clicking **Add** redirects you to
> the provider's authorization page in a new window.
>
> **1. Click Add on the Slack detail page**
>
> Adapt opens Slack's OAuth consent screen. You'll be asked to pick the
> Slack workspace you want to connect.
>
> **2. Authorize Adapt**
>
> Slack lists the permissions Adapt is requesting (reading channels and
> messages, posting on your behalf, reading user profiles, etc.). Click
> **Allow** to grant access.
>
> **3. Land back in Adapt**
>
> You're redirected to the Slack detail page in Adapt and the new
> connection appears under **adaptdotcom (organization)** with a green
> status dot. Adapt manages refresh tokens and re-auth from this point on
> — there's nothing to copy or paste.
>
> **4. Test it from a chat**
>
> Open a new chat and ask Adapt something that uses the connection — for
> example, *"Summarize yesterday's #engineering channel"* or *"DM Patrick
> the Q3 numbers"*. Adapt will pick up the new connection automatically.
>
> > [!TIP]
> >
> > You can connect multiple Slack workspaces — click **Add** again to
> > authorize a second one. Adapt will use whichever workspace matches the
> > channel or user you reference, and falls back to asking if it's
> > ambiguous.

> [tab] API key (example: Postgres)
>
> For API-key integrations like **Postgres**, clicking **Add** opens a modal
> where you paste your credentials. Adapt stores them securely and uses them
> only when it needs to query the service on your behalf.
>
> ![Connect modal for the Postgres API-key integration with a connection name field and a POSTGRES\_DATABASE\_URL credential field](https://mintcdn.com/adapt-fa4ae803/lVRVwua4eYnKPM6T/images/integrations/catalog/connect-modal.png?fit=max\&auto=format\&n=lVRVwua4eYnKPM6T\&q=85\&s=fa28cef3472d3e0e83cb39d408d2daea)
>
> **1. Click Add on the Postgres detail page**
>
> The **Connect Postgres** modal opens with an "API key" badge in the
> header.
>
> **2. Name the connection**
>
> The **Connection name** field is pre-filled with `Postgres`. Rename it
> if you're connecting more than one database (for example, `Postgres
>                 prod` and `Postgres staging`) so it's obvious which is which when Adapt
> chooses one to query.
>
> **3. Paste your credentials**
>
> Fill in the required credential — for Postgres, that's a single
> `POSTGRES_DATABASE_URL` connection string in the form
> `postgres://user:password@host:5432/dbname`. Other API-key integrations
> will list their own required keys here (for example, `STRIPE_API_KEY`,
> `SENTRY_AUTH_TOKEN`).
>
> **4. Click Add connection**
>
> The new connection appears under **adaptdotcom (organization)** and
> becomes available to everyone in your workspace.
>
> **5. Test it from a chat**
>
> Open a new chat and ask Adapt something that uses the connection — for
> example, *"How many users signed up in the last 7 days?"* for Postgres,
> or *"What did we charge yesterday?"* for Stripe.
>
> > [!TIP]
> >
> > Naming credentials with the convention the provider's docs use (for
> > example, `STRIPE_API_KEY` instead of `key1`) makes it easier for Adapt to
> > pick them up automatically when it decides which tool to call.

After connecting, the integration shows up under the **Connected** filter and
its tile gains a "Connected" badge. Who can use the connection depends on the
access scope you selected: organization connections are shared with your
workspace, while personal connections are available only to you.

## Personal connections

Every integration's detail page has two stacked panels:

* **`{Organization name}` (organization)** — shared with everyone in your
  workspace. Use this for accounts that should serve the whole team, like the
  company Slack or a shared HubSpot.
* **`{Your name}` (personal)** — visible only to you. Use this for accounts
  Adapt should act on for you alone, like your own Gmail, your personal
  GitHub, or a Postgres credential scoped to your work.

Each panel has its own **Add** button and its own list of connections.
Personal connections are supported for both OAuth integrations (Slack,
GitHub, Google Workspace, Notion, Linear, HubSpot, and others) and API-key
integrations (Stripe, Snowflake, Postgres, Sentry — anything in the catalog).

Adapt routes between them automatically: ask it to "draft a reply to Sarah's
email" and it uses your personal Gmail; ask it to "post the launch recap in
\#engineering" and it uses the org's Slack.

When you connect a personal OAuth account, you choose exactly which scopes
Adapt gets. Google Workspace, for example, lets you toggle Email, Calendar,
Contacts, and Drive independently, each as read or write.

### Why use a personal connection?

The clearest example is GitHub. With only an organization GitHub connection,
asking Adapt to open a pull request opens it as the `adaptcom` bot — the PR
and the commits are attributed to the bot account, not the person who asked
for the change. Connect your personal GitHub as a personal integration and
Adapt opens the PR as you, the commits are attributed to you, and reviewers
can see at a glance who's driving the work.

## OAuth integrations

OAuth is the simplest way to connect — sign in with your account, approve the
permissions, and you're done. Adapt handles refresh tokens and re-auth in the
background.

> [card] [Slack](https://v1-docs.adapt.com/docs/integrations/slack.md)
>
> Workspace-wide access

> [card] [GitHub](https://v1-docs.adapt.com/docs/integrations/github.md)
>
> Codebase access

> [card] [Linear](https://v1-docs.adapt.com/docs/integrations/linear.md)
>
> Issue tracking

> [card] [HubSpot](https://v1-docs.adapt.com/docs/integrations/hubspot.md)
>
> CRM & marketing

> [card] [Google Workspace](https://v1-docs.adapt.com/docs/integrations/google-workspace.md)
>
> Drive, Slides, Sheets

> [card] [Notion](https://v1-docs.adapt.com/docs/integrations/notion.md)
>
> Docs & wikis

## API key integrations

For everything else, paste your API key (or connection string) into the
integration's detail page. Credentials are stored securely and used only when
Adapt queries that service on your behalf.

The full catalog is below. Integrations with their own setup guide link to
that guide; the rest open directly in **Settings → Integrations**.

#### CRM & Sales

> [card] [HubSpot](https://v1-docs.adapt.com/docs/integrations/hubspot.md)
>
> CRM & marketing

> [card] [Attio](https://v1-docs.adapt.com/docs/integrations/attio.md)
>
> Modern CRM

> [card] [Clay](https://v1-docs.adapt.com/docs/integrations/clay.md)
>
> Data enrichment

> [card] [Salesforce](https://app.adapt.com/settings/integrations)
>
> Enterprise CRM

> [card] [Affinity](https://app.adapt.com/settings/integrations)
>
> Relationship intelligence CRM

> [card] [Apollo](https://app.adapt.com/settings/integrations)
>
> Sales engagement & data

> [card] [Klaviyo](https://app.adapt.com/settings/integrations)
>
> Email & SMS marketing

#### E-commerce

> [card] [Shopify](https://app.adapt.com/settings/integrations)
>
> Storefront, orders, customers

> [card] [WooCommerce](https://app.adapt.com/settings/integrations)
>
> WordPress storefront

#### Marketing & Analytics

> [card] [Google Analytics](https://v1-docs.adapt.com/docs/integrations/google-analytics.md)
>
> Web & app traffic

> [card] [Ahrefs](https://v1-docs.adapt.com/docs/integrations/ahrefs.md)
>
> SEO & backlinks

> [card] [PostHog](https://app.adapt.com/settings/integrations)
>
> Product analytics

> [card] [Mixpanel](https://app.adapt.com/settings/integrations)
>
> Product analytics

> [card] [Meta Ads](https://v1-docs.adapt.com/docs/integrations/meta-ads.md)
>
> Facebook & Instagram ads

#### Payments

> [card] [Stripe](https://v1-docs.adapt.com/docs/integrations/stripe.md)
>
> Payments & subscriptions

> [card] [Ramp](https://app.adapt.com/settings/integrations)
>
> Spend management & cards

#### Communication

> [card] [Slack](https://v1-docs.adapt.com/docs/integrations/slack.md)
>
> Workspace messaging

> [card] [Intercom](https://v1-docs.adapt.com/docs/integrations/intercom.md)
>
> Customer messaging

> [card] [Zendesk](https://v1-docs.adapt.com/docs/integrations/zendesk.md)
>
> Support tickets

> [card] [Grain](https://v1-docs.adapt.com/docs/integrations/grain.md)
>
> Meeting transcripts

> [card] [Zoom](https://app.adapt.com/settings/integrations)
>
> Meeting recordings

> [card] [Fireflies](https://app.adapt.com/settings/integrations)
>
> Meeting transcripts

> [card] [Gong](https://app.adapt.com/settings/integrations)
>
> Revenue conversations

> [card] [Resend](https://app.adapt.com/settings/integrations)
>
> Transactional email

> [card] [SendGrid](https://app.adapt.com/settings/integrations)
>
> Transactional email

> [card] [Twilio](https://app.adapt.com/settings/integrations)
>
> SMS & voice

> [card] [Discord](https://app.adapt.com/settings/integrations)
>
> Community messaging

> [card] [Customer.io](https://app.adapt.com/settings/integrations)
>
> Lifecycle messaging

#### Monitoring & Compliance

> [card] [Sentry](https://v1-docs.adapt.com/docs/integrations/sentry.md)
>
> Error monitoring

> [card] [Drata](https://v1-docs.adapt.com/docs/integrations/drata.md)
>
> Compliance automation

> [card] [Datadog](https://app.adapt.com/settings/integrations)
>
> Infrastructure & APM

> [card] [Vanta](https://v1-docs.adapt.com/docs/integrations/vanta.md)
>
> Compliance automation

#### Cloud & Dev Tools

> [card] [GitHub](https://v1-docs.adapt.com/docs/integrations/github.md)
>
> Code, issues, PRs

> [card] [Linear](https://v1-docs.adapt.com/docs/integrations/linear.md)
>
> Issue tracking

> [card] [Notion](https://v1-docs.adapt.com/docs/integrations/notion.md)
>
> Docs & wikis

> [card] [Google Cloud](https://v1-docs.adapt.com/docs/integrations/gcp.md)
>
> GCP services

> [card] [AWS](https://app.adapt.com/settings/integrations)
>
> EC2, S3, Lambda

> [card] [Azure](https://app.adapt.com/settings/integrations)
>
> Microsoft cloud

> [card] [Vercel](https://app.adapt.com/settings/integrations)
>
> Deployments & hosting

> [card] [Doppler](https://v1-docs.adapt.com/docs/integrations/doppler.md)
>
> Secrets management

> [card] [Asana](https://app.adapt.com/settings/integrations)
>
> Work management

> [card] [Jira](https://app.adapt.com/settings/integrations)
>
> Issue tracking

> [card] [Confluence](https://app.adapt.com/settings/integrations)
>
> Wiki & docs

> [card] [Figma](https://app.adapt.com/settings/integrations)
>
> Design files

#### Databases

> [card] [Snowflake](https://v1-docs.adapt.com/docs/integrations/snowflake.md)
>
> Data warehouse

> [card] [Databricks](https://v1-docs.adapt.com/docs/integrations/databricks.md)
>
> Lakehouse

> [card] [Postgres](https://app.adapt.com/settings/integrations)
>
> Relational database

> [card] [Supabase](https://app.adapt.com/settings/integrations)
>
> Managed Postgres backend

> [card] [Neon](https://app.adapt.com/settings/integrations)
>
> Serverless Postgres

> [card] [MySQL](https://app.adapt.com/settings/integrations)
>
> Relational database

> [card] [MongoDB](https://app.adapt.com/settings/integrations)
>
> Document database

> [card] [Airtable](https://app.adapt.com/settings/integrations)
>
> Spreadsheet-database

#### AI & ML

> [card] [OpenAI](https://app.adapt.com/settings/integrations)
>
> GPT, embeddings, image

> [card] [Anthropic](https://app.adapt.com/settings/integrations)
>
> Claude models

## Custom integrations

If a tool you use isn't in the catalog yet, you can bring your own. Filter the
catalog to **Custom** and click **Add custom integration** — you'll be
prompted to name the integration and add the credentials Adapt should use
when calling its API.

![Custom category in the catalog with the Add custom integration tile](https://mintcdn.com/adapt-fa4ae803/lVRVwua4eYnKPM6T/images/integrations/catalog/catalog-custom-category.png?fit=max\&auto=format\&n=lVRVwua4eYnKPM6T\&q=85\&s=11748225ca1d3ce9b58539fd79c84ca9)

Under **Who should have access?**, choose **Organization** to share the custom
integration with everyone in your workspace, or **Personal** to make it
accessible only to you.

Once added, custom integrations behave like any other connection: they appear
under the **Connected** filter and can be edited or removed at any time.

## Connection health

Adapt monitors your OAuth connections and tells you when one stops working —
for example, when a token expires, a grant is revoked, or a token refresh
fails. You don't have to wait for a workflow to break to find out.

When a connection needs attention, you'll see it in three places:

* A **banner** at the top of **Settings → Integrations** counts the affected
  connections and links to them with a **Review** button.
* The integration's tile shows an amber **Needs re-auth** dot instead of the
  green **Connected** dot.
* A **Needs attention** filter in the sidebar groups every connection that
  needs reconnecting.

![Integrations catalog showing a banner reading 2 connections need to be reconnected, with Slack and GitHub tiles flagged Needs re-auth under a Needs attention filter](https://mintcdn.com/adapt-fa4ae803/fmS6ozD_XAgLwnvw/images/integrations/catalog/needs-attention.png?fit=max\&auto=format\&n=fmS6ozD_XAgLwnvw\&q=85\&s=60062d7b4cddfaa206c2e59216d08f26)

To fix a flagged connection, open the integration and reconnect it.
Re-authorizing clears the error and returns the connection to healthy
automatically.

## Managing connections

Click any **Connected** integration to open its detail page, where you can:

* See the active connections, who added them, and the permissions granted
* For **OAuth** (e.g., Slack): re-authorize if a connection needs attention,
  add another workspace, or disconnect entirely
* For **API key** (e.g., Postgres): rotate the credential, add additional
  secrets, or remove the connection

Connections are scoped to your organization, so changes apply to everyone in
the workspace.

## Next Steps

> [card] [Slack Setup](https://v1-docs.adapt.com/docs/integrations/slack.md)
>
> Connect your workspace

> [card] [Postgres Setup](https://v1-docs.adapt.com/docs/integrations/postgresql.md)
>
> Connect your database


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.