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

# Overview

> Connectors are software components that enable different applications, systems, or platforms to communicate and share data with each other.

## What are Connectors?

Connectors are software components that **sync and index data** from external applications into PipesHub. They enable your chatbot and agents to search through your organization's knowledge base.

**Use Connectors when you want to query or search data.** The indexed data becomes searchable knowledge for your AI assistants.

**Key characteristics:**

* **One-way data sync** - Import data into PipesHub for indexing
* **Knowledge retrieval** - Make data searchable for AI assistants
* **Periodic syncing** - Data is synced on a schedule, not in real-time

<Warning>
  **Important:** When authenticating a connector, use the same email address as your PipesHub account. Using a different email will cause permission issues on the PipesHub platform.
</Warning>

<Note>
  **When you want to use both Connector and Toolset:** In the Agent Builder add nodes from **Knowledge** (Collections, API Apps) for document search and context retrieval, and add nodes from **Tools** for performing actions. Connect both to your Agent Core so the agent can search context and take action in the same conversation.
</Note>

***

## Available Connectors

Our platform supports a wide range of connectors organized by ecosystem to help you integrate with your favorite tools and services.

***

### Google Workspace

| Connector           | Description                                                        |
| ------------------- | ------------------------------------------------------------------ |
| **Gmail**           | Access and manage email communications, create automated workflows |
| **Google Calendar** | Sync events, create meetings, and manage scheduling                |
| **Google Drive**    | File storage, sharing, and collaboration management                |
| **Google Docs**     | Document creation, editing, and collaboration                      |
| **Google Sheets**   | Spreadsheet data management and analysis                           |
| **Google Slides**   | Presentation creation and sharing                                  |
| **Google Forms**    | Survey and form data collection                                    |
| **Google Meet**     | Video conferencing integration                                     |
| **Google Admin**    | Workspace administration and user management                       |
| **YouTube**         | Video content management and analytics                             |

***

### Microsoft Ecosystem

| Connector      | Description                            |
| -------------- | -------------------------------------- |
| **Outlook**    | Email and calendar management          |
| **OneDrive**   | Cloud file storage and synchronization |
| **OneNote**    | Note-taking and knowledge management   |
| **Teams**      | Team collaboration and communication   |
| **SharePoint** | Document management and team sites     |
| **Planner**    | Task and project management            |

***

### Atlassian

| Connector      | Description                                             |
| -------------- | ------------------------------------------------------- |
| **Jira**       | Issue tracking, project management, and agile workflows |
| **Confluence** | Team collaboration and knowledge base management        |

***

### Communication & Support

| Connector   | Description                               |
| ----------- | ----------------------------------------- |
| **Slack**   | Team messaging and collaboration          |
| **Zammad**  | Open-source helpdesk and ticketing system |
| **Zendesk** | Customer support and ticket management    |

***

### Web and feeds

| Connector | Description                                                                             |
| --------- | --------------------------------------------------------------------------------------- |
| **Web**   | Crawl and index publicly reachable pages and files from a website URL                   |
| **RSS**   | Subscribe to and sync items from public RSS and Atom feeds (optional full article text) |

***

### Local storage

| Connector    | Description                                                                                                                               |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Local FS** | Index a folder on the connector host; set up under **Workspace Settings → Your Connectors**; optional desktop watcher in the Electron app |

***

### Local storage

| Connector    | Description                                                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Local FS** | Index a folder on the connector host; set up under **Personal → Your Connectors**; optional desktop watcher in the Electron app |

***

### Cloud Storage & Infrastructure

| Connector                       | Description                                     |
| ------------------------------- | ----------------------------------------------- |
| **Amazon S3**                   | Scalable object storage and data management     |
| **Microsoft Azure**             | Cloud computing platform and services           |
| **Google Cloud Platform (GCP)** | Google's cloud infrastructure services          |
| **Box**                         | Enterprise content management and collaboration |
| **Dropbox**                     | File synchronization and cloud storage          |
| **Nextcloud**                   | Self-hosted file sync and share platform        |

***

### Development & Project Management

| Connector  | Description                                                 |
| ---------- | ----------------------------------------------------------- |
| **GitHub** | Version control, code collaboration, and project management |
| **Linear** | Modern issue tracking and project management                |
| **Notion** | All-in-one workspace for notes, docs, and projects          |

***

### Database & Analytics

| Connector      | Description                                               |
| -------------- | --------------------------------------------------------- |
| **Airtable**   | Flexible database and project management                  |
| **MariaDB**    | Tables and rows sync from a MariaDB database              |
| **PostgreSQL** | Schemas, tables, and rows sync from a PostgreSQL database |

***

## Security & Compliance

All connectors are built with enterprise-grade security in mind, supporting OAuth 2.0 authentication, data encryption, and compliance with major industry standards including SOC 2, GDPR, and HIPAA where applicable.

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What's the difference between Connectors and Toolsets?">
    | Aspect          | Connectors                          | Toolsets                         |
    | --------------- | ----------------------------------- | -------------------------------- |
    | **Purpose**     | Sync and index data for search      | Enable agents to perform actions |
    | **Data Flow**   | One-way (import data into PipesHub) | Two-way (read and write via API) |
    | **When to Use** | Query/search data                   | Perform actions on data          |

    **Example:** Use a **Gmail Connector** to index and search your email history. Use a **Gmail Toolset** to send new emails through an agent.
  </Accordion>

  <Accordion title="When should I use a Connector vs a Toolset?">
    **Connector** — Use when you need document context search: connectors sync and index your documents, emails, and pages so your assistant can find and use that context, and they do not perform actions.

    **Toolset** — When you need **actions**: create or update content, send messages, or run analytical queries (e.g. JQL, CQL, reports).

    **Quick takeaway:** Search & context → **Connector**. Actions → **Toolset**.
  </Accordion>

  <Accordion title="Where do I find the callback URL for my OAuth app?">
    The callback URL is displayed in PipesHub when configuring a connector:

    1. Go to **Settings > Connectors**
    2. Click **"Configure"** on the connector you want to set up
    3. Copy the **Redirect URI** shown in the dialog
    4. Add it to your OAuth app's allowed redirect URIs in the service's developer console

    The callback URL must match exactly between PipesHub and the OAuth app for authentication to succeed.
  </Accordion>

  <Accordion title="What OAuth scopes do Connectors require?">
    Connectors need **read-only permissions** to sync and index data. When creating your OAuth app in the service's developer console, grant only the scopes listed in the specific connector's documentation page.

    Using read-only scopes ensures connectors can access your data for indexing but cannot modify or delete anything in your external applications.
  </Accordion>

  <Accordion title="Queries not returning results. What could be wrong?">
    There are three common causes:

    1. **Email mismatch** - The email used during connector authentication doesn't match your PipesHub account email. This causes permission issues preventing you from accessing synced data.
       * **Fix:** Reconfigure the connector and authenticate using the same email as your PipesHub account.

    2. **Records not displaying in "All Records"** - Documents or data from the connector are not showing up at all in the All Records section.
       * **Fix:** Check permissions in the connector configuration, verify email match, and go to **Settings > Connectors** to ensure all records have synced successfully.

    3. **Data not yet indexed** - The connector is still syncing or hasn't completed the initial indexing process.
       * **Fix:** Go to **Settings > Connectors**, check the sync status, and wait for indexing to complete.
  </Accordion>
</AccordionGroup>