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

# What are connectors?

> Learn how IdeaBoxAI connectors bridge the platform to your external data sources, business tools, and communication services.

Connectors in IdeaBoxAI bridge the platform to your external data sources, business tools, and communication services. Every piece of live data that an agent queries, every email it sends, and every CRM record it reads flows through a configured connector.

<Info>
  Connectors are configured per-organisation and scoped by persona permissions. Users only access data they are authorised to use.
</Info>

## Accessing connections

Navigate to **Connections** in the left sidebar. The Connections page is divided into two tabs, each covering a different category of integration.

<img src="https://mintcdn.com/ideabodxai/Afptgwm2u83OxXY6/images/connectors/conn/conn2.png?fit=max&auto=format&n=Afptgwm2u83OxXY6&q=85&s=49d721b6deb310486a39d9e6a75dbad3" alt="The Connections page showing the Connectors tab with Google Drive, Confluence, Zeenea, and other service integrations" width="3420" height="1980" data-path="images/connectors/conn/conn2.png" />

| Tab            | What it contains                                                                                                                                                                                                                                     |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connectors** | OAuth and API-based service integrations — Google Drive, Confluence, Zeenea, Salesforce, HubSpot, Zoho CRM, Dynamics 365, Gong, and ZoomInfo. Click **Connect** to authenticate each service. Use **+ Add Custom** to register a custom integration. |
| **Databases**  | Org-wide database connections (PostgreSQL, MySQL, Snowflake, and others). Named connections here are reusable across knowledge bases. Admin permissions may be required to add or remove connections.                                                |

## How to connect a connector

The following steps walk through how to connect an external service to IdeaBoxAI. Google Drive is used as an example, but the same flow applies to all OAuth-based connectors.

<Steps>
  <Step title="Go to Settings">
    Go to **Settings** in the left sidebar to go to Connections.

    <img src="https://mintcdn.com/ideabodxai/MjikS3fmsNCHayce/images/connectors/connector_howtoconnect/step1.png?fit=max&auto=format&n=MjikS3fmsNCHayce&q=85&s=eba0bafa7784a62bed14dd7e9d79a130" alt="Profile section in the top corner of the platform" width="1914" height="958" data-path="images/connectors/connector_howtoconnect/step1.png" />
  </Step>

  <Step title="Browse and Search for the connector you want">
    The Connectors page displays all available integrations across different categories. Use the **search bar** to find a specific connector. For example, type "Google Drive" to filter the list and locate the Google Drive connector.

    <img src="https://mintcdn.com/ideabodxai/cNlvJ38WQc9bYQcY/images/connectors/connector_howtoconnect/step4.png?fit=max&auto=format&n=cNlvJ38WQc9bYQcY&q=85&s=2a62a6da79375ccc53da1220ae6a1dab" alt="Connectors page showing all available connector cards" width="1911" height="952" data-path="images/connectors/connector_howtoconnect/step4.png" />
  </Step>

  <Step title="Connect your Google account">
    Click the **Connect** button on the Google Drive connector card. The platform navigates to the **Connect your Google account** screen. Sign in with your Google credentials and grant the requested permissions.

    <img src="https://mintcdn.com/ideabodxai/aZuywo89vbz97Pl8/images/connectors/connector_howtoconnect/step6.png?fit=max&auto=format&n=aZuywo89vbz97Pl8&q=85&s=2e9be804280e41fbe7d05b8222e40cc0" alt="Connect your Google account screen showing the Google OAuth sign-in prompt" width="2996" height="1686" data-path="images/connectors/connector_howtoconnect/step6.png" />
  </Step>

  <Step title="Google Drive connected successfully">
    After authenticating, the Google Drive connector shows a **Connected** status on the Connectors page. The integration is now active and ready to use across agents, knowledge bases, and automations.

    <img src="https://mintcdn.com/ideabodxai/cNlvJ38WQc9bYQcY/images/connectors/connector_howtoconnect/step7.png?fit=max&auto=format&n=cNlvJ38WQc9bYQcY&q=85&s=fcaee09c7579d6f17cde4097651f5ad8" alt="Google Drive connector card showing Connected status" width="1911" height="952" data-path="images/connectors/connector_howtoconnect/step7.png" />
  </Step>
</Steps>

<Tip>
  The same steps apply to all OAuth-based connectors. For connectors that use API keys or tokens instead of OAuth, you will be prompted to enter your credentials in a modal after clicking Connect.
</Tip>

## Connection layers

IdeaBoxAI uses connections to integrate with external data sources and services. Connectors are configured inside knowledge bases to provide access to databases, documents, and cloud services.

| Layer                          | What it does                                                                                                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Knowledge base connections** | Database and document connectors configured inside a knowledge base. These provide access to structured or unstructured data, such as a PostgreSQL database, a Snowflake warehouse, or a set of uploaded documents. |

## How connectors power the platform

IdeaBoxAI workflows depend on connectors to access data and services. The following table shows how connectors support different platform features.

| Platform feature  | Connection used                                         | Example                                                                           |
| ----------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Knowledge bases   | Database connector (PostgreSQL, Snowflake, MySQL)       | Query sales tables through an ODBC driver.                                        |
| Data queries      | Structured KB connection                                | Query a data warehouse for pipeline statistics.                                   |
| Document search   | Unstructured KB (Confluence, Google Drive, file upload) | Search Confluence for RFP answer library content.                                 |
| Email integration | Gmail or Microsoft Mail 365 connector                   | Send follow-up emails from a configured account.                                  |
| CRM integration   | Salesforce, HubSpot, or Zoho CRM connector              | Log call notes back into a Salesforce opportunity.                                |
| Automations       | All of the above, chained in sequence                   | Scheduled automation queries a knowledge base, generates a report, and emails it. |

## Core value proposition

Connectors deliver measurable improvements by removing manual data retrieval and enabling AI-powered workflows.

* Query live databases and documents through natural language without writing SQL or switching tools.
* Send emails, post to Slack, and update CRM records directly from the agent chat interface.
* Combine multiple data sources in a single agent for comprehensive, cross-system intelligence.
* Automate multi-step workflows that span databases, documents, and communication tools.
* Maintain security through per-persona permission scoping and organisation-level configuration.

## Next steps

Explore the following guides to configure your connectors.

<CardGroup cols={2}>
  <Card title="Knowledge base connections" icon="database" href="/connectors/knowledge-base-connections">
    Connect databases, documents, and cloud warehouses to your knowledge bases.
  </Card>

  <Card title="Connector directory" icon="grid-2" href="/connectors/connector-directory">
    Browse all available connectors by category with setup requirements.
  </Card>

  <Card title="Troubleshooting" icon="circle-exclamation" href="/connectors/troubleshooting">
    Resolve common connection issues for databases and imports.
  </Card>
</CardGroup>
