> ## Documentation Index
> Fetch the complete documentation index at: https://relevanceai.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrations
> Connect your GTM tools to Super GTM via OAuth, API key, or built-in integrations
Super GTM connects to your go-to-market tech stack so the agent can read data and take actions across your tools. Integrations are managed from the Super GTM settings panel.
## Connecting integrations
Click the gear icon next to the Super GTM toggle.
Navigate to the **Integrations** section and locate the tool you want to connect.
Click **Connect account** (OAuth) or **Add API key** (API key integrations) and follow the prompts.
### Connection methods
You click **Connect**, log in to the third-party service, and Relevance securely stores your tokens. No manual key management needed.
1. Click **Connect** on the integration
2. A modal opens and redirects you to the third-party login (e.g. Google, HubSpot)
3. Authorize the requested scopes
4. The integration shows as connected and is immediately available
Each user must connect their own OAuth integrations individually. For per-user OAuth setup at the organizational level, see [user-level authentication](/enterprise/user-level-authentication).
You paste in a key from the third-party platform's settings page.
Enter API keys via the integrations settings page — accessible from the Super GTM settings panel (click the external link icon on the integration) or from your project's Integrations page directly.
A project admin can configure API key integrations at the project level (e.g. a shared Gong API key for the whole team), so individual users don't need to connect personally — they inherit the project's credentials. Admins can manage these in the builders app under [Integrations & API Keys](/get-started/core-concepts/api-integration).
Depending on how your organization has configured each external application, you may need to request admin access to enable OAuth or to obtain an API key. Check with your IT team or the admin of the external application.
### Managing connections
All active integrations are visible in the Super GTM settings panel. Each integration has one of three states:
Integration is active and the agent can use it
Credentials exist but you've toggled it off in your settings
No credentials stored — a "Connect" button is shown
### Write approval
Every integration action is classified as either a read or a write (create, update, delete). You control how the agent handles writes.
The agent pauses and asks for your approval before writing to any integration — e.g. "I'm about to create a contact in HubSpot — approve?"
The agent executes writes automatically without asking for confirmation.
Override write approval on a per-integration basis from the settings modal. For example: auto-approve Slack posts but always require approval for HubSpot CRM updates.
Certain built-in Agents (like Explorer) are hardcoded to read-only — they can query and search integrations but cannot write anything, regardless of your approval settings.
### Setup details
**Connection method:** OAuth
Gives Super GTM read and write access to your HubSpot CRM — search contacts, companies, and deals; create and update records; manage sequences and pipelines; pull activity history.
HubSpot requests a broad set of optional scopes (contacts, companies, deals, files, tickets, automation sequences, sales email, pipeline management). This is intentional to enable the full range of Super GTM workflows. You can review and approve scopes during the OAuth flow.
**How to connect:**
1. In the Super GTM settings panel, find **HubSpot** under Integrations
2. Click **Connect account**
3. Sign in to HubSpot and authorize access when prompted
4. Select the HubSpot portal to connect if you have multiple
**Things to know:**
* Each user must authorize their own HubSpot connection
* If your HubSpot portal restricts app installations, a HubSpot admin needs to enable App Marketplace access for your user — see [Troubleshooting](#troubleshooting) below
* The agent respects your HubSpot user permissions — it can only access records you have permission to see
**Connection method:** OAuth
**Additional field:** **Sandbox account** checkbox — enable this if you're connecting a Salesforce sandbox (test/staging) environment. Routes login to test.salesforce.com instead of login.salesforce.com.
Connects Super GTM to your Salesforce org — full API access with read and write CRM data, SOQL queries, and actions across Salesforce objects.
**How to connect:**
1. In the Super GTM settings panel, find **Salesforce** under Integrations
2. If you're connecting a sandbox (test/staging) environment, check **Sandbox account** before proceeding — this routes login to test.salesforce.com instead of login.salesforce.com
3. Click **Connect account**
4. Sign in to Salesforce and authorize the connection
5. If your org requires admin approval for connected apps, request access from your Salesforce admin
**Things to know:**
* Salesforce organizations often require admin approval for new OAuth apps — see [Troubleshooting](#troubleshooting) below if the connection fails
* The agent operates within your Salesforce user permissions and sharing rules
* Custom objects and fields are accessible if they're visible to your user profile
**Connection method:** API key
Gives Super GTM access to Apollo's sales intelligence database — search and enrich contact and company data, find contact information, pull prospect details.
**How to connect:**
1. Log in to Apollo and navigate to Settings > Integrations > API
2. Generate an API key
3. In the Super GTM settings panel, find **Apollo** under Integrations
4. Click **Add API key** and paste your Apollo API key
**Things to know:**
* Apollo API keys are scoped to your Apollo account — each user needs their own key, or an admin can add a shared project-level key
* API usage counts against your Apollo plan's API limits
**Connection method:** API key
Connects Super GTM to Gong call recordings and transcripts — pull call data, surface key moments, incorporate conversation intelligence into deal briefings.
**How to connect:**
1. In Gong, navigate to Settings > Ecosystem > API
2. Generate an API key (requires Gong admin access)
3. In the Super GTM settings panel, find **Gong** under Integrations
4. Click **Add API key** and enter your Gong API credentials
**Things to know:**
* Gong API access typically requires Technical Admin permissions in Gong — check with your Gong admin
* The agent can only access calls that are already processed and indexed in Gong
**Connection method:** API key
Connects Super GTM to your Salesloft account for sales engagement workflows.
**How to connect:**
1. Log in to Salesloft and navigate to your API settings
2. Generate an API key
3. In the Super GTM settings panel, find **Salesloft** under Integrations
4. Click **Add API key** and paste your Salesloft API key
**Connection method:** OAuth
Connects Super GTM to your Slack workspace — read and post messages, search conversations, list users, manage channels, add reactions.
**How to connect:**
1. In the Super GTM settings panel, find **Slack** under Integrations
2. Click **Connect account**
3. Select your Slack workspace and authorize the requested permissions
4. If your workspace restricts app installations, request approval from your Slack admin
**Things to know:**
* Slack workspace admins can restrict which apps users can install — if the authorization fails, you may need admin approval
* The agent can only read messages in channels it has been added to, and public channels
* Posting to channels requires the agent to have access to those channels
**Connection method:** OAuth (via GSuite)
Connects Super GTM to your Gmail account — compose, read, send, and draft emails, manage labels, modify settings.
**How to connect:**
1. In the Super GTM settings panel, find **GSuite** under Integrations
2. Click **Connect account** and sign in with your Google account
3. Grant the requested Gmail permissions
4. If your Google Workspace organization restricts third-party app access, contact your Google Workspace admin
**Things to know:**
* Gmail access is part of the GSuite integration, which also covers Google Calendar, Google Docs, Google Drive, and Google Sheets
* Google Workspace organizations often have policies restricting which apps can access Gmail — your admin may need to approve the connection
* Sent emails appear in your Gmail Sent folder as normal
**Connection method:** OAuth
Connects Super GTM to your Microsoft Outlook account — read, send, and draft emails, manage labels and mailbox settings.
**How to connect:**
1. In the Super GTM settings panel, find **Microsoft Outlook** under Integrations
2. Click **Connect account**
3. Sign in with your Microsoft account and grant the requested permissions
4. If your Microsoft 365 tenant restricts app consent, your IT admin may need to grant admin consent
**Things to know:**
* Microsoft 365 organizations often require admin consent for third-party OAuth apps — contact your IT admin if the authorization fails
* The connection covers your personal Outlook mailbox; shared mailboxes may require additional configuration
**Connection method:** OAuth
Gives Super GTM access to your Microsoft Teams environment — read and send chat and channel messages, read meeting transcripts, manage online meetings.
**How to connect:**
1. In the Super GTM settings panel, find **Microsoft Teams** under Integrations
2. Click **Connect account**
3. Sign in with your Microsoft account and authorize the connection
4. Admin consent is typically required for Teams app integrations — work with your IT admin
**Things to know:**
* Teams API access almost always requires Microsoft 365 admin consent — plan for this when setting up
* Meeting transcript access requires that transcription is enabled in your Teams tenant
**Connection method:** OAuth (via GSuite)
Connects Super GTM to your Google Calendar — check availability, create events, get scheduling context.
**How to connect:**
Google Calendar access is included with the GSuite integration. Connect via the **GSuite** option in the Integrations section.
**Things to know:**
* Calendar access is part of the GSuite integration alongside Gmail, Google Docs, Google Drive, and Google Sheets
* The agent can only create events on calendars you have write access to
* Meeting invitations sent by the agent will come from your Google account
**Connection method:** OAuth
Connects Super GTM to Microsoft Calendar (via Microsoft 365) — create and manage calendar events, including shared calendars.
**How to connect:**
1. In the Super GTM settings panel, find **Microsoft Calendar** under Integrations
2. Click **Connect account**
3. Sign in with your Microsoft account and authorize the connection
**Things to know:**
* Microsoft Calendar access is separate from Microsoft Outlook — you can connect either or both
* Shared calendar access depends on your Microsoft 365 permissions
**Connection method:** OAuth (via GSuite)
Connects Super GTM to Google Docs — read and edit documents, pull content from existing docs, create new documents.
**How to connect:**
Google Docs access is included with the GSuite integration. Connect via the **GSuite** option in the Integrations section.
**Things to know:**
* Google Docs access is part of the GSuite integration alongside Gmail, Google Calendar, Google Drive, and Google Sheets
* The agent can only access documents shared with or owned by your Google account
**Connection method:** OAuth (via GSuite)
Connects Super GTM to Google Drive — read and write files, search across your Drive.
**How to connect:**
Google Drive access is included with the GSuite integration. Connect via the **GSuite** option in the Integrations section.
**Things to know:**
* Google Drive access is part of the GSuite integration
* The agent can only access files shared with or owned by your Google account
**Connection method:** OAuth (via GSuite)
Connects Super GTM to Google Sheets — read and write spreadsheet data.
**How to connect:**
Google Sheets access is included with the GSuite integration. Connect via the **GSuite** option in the Integrations section.
**Things to know:**
* Google Sheets access is part of the GSuite integration
* The agent can only access spreadsheets shared with or owned by your Google account
**Connection method:** OAuth
Connects Super GTM to your Notion workspace — read and create pages, query and create databases, create comments, manage blocks, search.
**How to connect:**
1. In the Super GTM settings panel, find **Notion** under Integrations
2. Click **Connect account**
3. Sign in to Notion and select which pages and databases to share with the integration
4. Notion requires you to explicitly grant access to each page or database — the agent can only see what you've shared
**Things to know:**
* Notion's permission model is selective: you must share specific pages or databases during the OAuth flow. The agent cannot see anything you haven't explicitly shared.
* If you want the agent to access new Notion pages in the future, you'll need to update the connection to include them
**Connection method:** OAuth or API key
Linear is the only integration that supports both OAuth and API key. You can choose whichever you prefer — both methods work interchangeably. If either is configured, the integration shows as connected.
Connects Super GTM to Linear — read, create, update, and archive issues, manage comments, read projects and labels.
**How to connect:**
*OAuth (per user):*
1. In the Super GTM settings panel, find **Linear** under Integrations
2. Click **Connect account** and authorize via your Linear account
*API key (project-level):*
1. In Linear, navigate to Settings > Security & access > Personal API keys
2. Create a new API key
3. In the Super GTM settings panel, find **Linear** under Integrations
4. Click **Add API key** and paste your Linear API key
**Connection method:** API key
Connects Super GTM to Ashby for recruiting and ATS workflows.
**How to connect:**
1. Log in to Ashby and navigate to your API settings
2. Generate an API key
3. In the Super GTM settings panel, find **Ashby** under Integrations
4. Click **Add API key** and paste your Ashby API key
**Connection method:** API key
Connects Super GTM to Avoma for meeting intelligence — access call recordings, transcripts, and meeting notes.
**How to connect:**
1. Log in to Avoma and navigate to your API settings
2. Generate an API key
3. In the Super GTM settings panel, find **Avoma** under Integrations
4. Click **Add API key** and paste your Avoma API key
**Connection method:** API key
Connects Super GTM to Firmable for company data enrichment.
**How to connect:**
1. Log in to Firmable and navigate to your API settings
2. Generate an API key
3. In the Super GTM settings panel, find **Firmable** under Integrations
4. Click **Add API key** and paste your Firmable API key
**Connection method:** API key
Connects Super GTM to ZoomInfo for contact and company intelligence. ZoomInfo is the only integration that requires three separate fields instead of a single API key.
**Required fields:**
* **ZoomInfo Email** — your ZoomInfo account email address
* **ZoomInfo Client ID** — your ZoomInfo API client ID
* **ZoomInfo Private Key** — your ZoomInfo private key (this is a multi-line key, pasted into a larger text area)
**How to connect:**
1. Log in to ZoomInfo and navigate to your account settings
2. Locate your **Email**, **Client ID**, and **Private Key**
3. In the Super GTM settings panel, find **ZoomInfo** under Integrations
4. Enter all three values
**Connection method:** API key
Connects Super GTM to Cursor — list, launch, and stop agents, view conversation history, send follow-up prompts.
**How to connect:**
1. In Cursor, navigate to your account settings and find the API section
2. Generate an API key
3. In the Super GTM settings panel, find **Cursor** under Integrations
4. Click **Add API key** and paste your Cursor API key
### Troubleshooting
When connecting Salesforce to Relevance AI, you may encounter one of these OAuth errors:
This error occurs when the Relevance AI connected app in Salesforce needs to be configured to allow admin-approved users.
A Salesforce administrator must complete these steps:
In Salesforce, click the gear icon in the top right and select **Setup**.
Search for and open **Connected Apps OAuth Usage**.
If the **Relevance AI** app is not already installed, click **Install**. This redirects to the app settings page — skip to step 5.
Navigate to **Manage Connected Apps** and click **Relevance AI**.
This opens the Connected App Detail page for Relevance AI.
Click the **Edit Policies** button on the Connected App Detail page.
Under **OAuth Policies**, set the **Permitted Users** dropdown to one of:
**All users may self-authorize** — any Salesforce user can connect to Relevance AI.
**Admin approved users are pre-authorized** — only users with specific profiles or permission sets can connect. If you choose this option, scroll down to the **Profiles** and **Permission Sets** sections to assign access.
Use **Manage Profiles** or **Manage Permission Sets** to select which users can connect.
If you don't see the Relevance AI app in Connected Apps OAuth Usage, initiate the connection from the Super GTM settings panel first — this registers the app in your Salesforce org.
If a user can't install the Relevance App from the HubSpot App Marketplace, they likely don't have the **App Marketplace access** permission enabled on their account. A HubSpot Super Admin (or any admin with permission to manage users) needs to grant this.
Log in to HubSpot and click the **Settings** gear icon in the top navigation bar.
In the left sidebar, click **Users & Teams**. This shows a list of all users in your HubSpot account.
Find the user who needs access and click **Edit permissions**. This opens the permissions editor.
Scroll down to **Account / Settings Access** (or search for "App Marketplace") and toggle **App Marketplace access** to **ON**. You may also want to enable **App Marketplace uninstall access** if the user should be able to remove apps later.
Click **Save** to apply the new permissions. The user now has App Marketplace access and can install the Relevance App.
To grant access to multiple users at once, select the checkboxes next to each user in the Users & Teams list (they must share the same seat type), click **Edit permissions** at the top, toggle on **App Marketplace access**, and save.
On HubSpot Enterprise, you can also add **App Marketplace access** to an existing Permission Set under **Settings** > **Users & Teams** > **Permission Sets** — all users assigned to that set will automatically receive the permission.
If the permission changes don't take effect immediately, have the user open HubSpot in a private/incognito browser window. If it works there, they just need to clear their browser cache and cookies, then reload HubSpot.