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

# Connectors overview

> Connect your tools to Hadiq.io and get instant, permission-aware answers across all your data.

Connectors pull content from your tools into Hadiq.io's search index. Once connected, Hadiq.io continuously syncs in the background so search results reflect your latest data — no manual refreshes needed.

## How connectors work

Hadiq.io takes a pre-indexing approach: content is fetched, chunked, embedded, and stored in a hybrid search index before any query is made. When you ask a question, Hadiq.io searches across the full index and returns cited answers in milliseconds.

This is different from MCP connectors, which fetch live data at query time:

|                           | Hadiq.io indexed connectors | MCP live query                |
| ------------------------- | --------------------------- | ----------------------------- |
| Sync model                | Continuous background sync  | Fetches at query time         |
| Speed                     | Instant                     | Depends on source API latency |
| Cross-source search       | Yes, in a single query      | No                            |
| Permission awareness      | Yes                         | No                            |
| Works when source is slow | Yes                         | No                            |

## Available connectors

Hadiq.io supports 40+ connectors. Major integrations include:

<CardGroup cols={3}>
  <Card title="Slack" icon="slack" href="/connectors/slack">
    Messages, threads, and channels
  </Card>

  <Card title="Google Drive" icon="google-drive" href="/connectors/google-drive">
    Docs, Sheets, Slides, and PDFs
  </Card>

  <Card title="Gmail" icon="envelope">
    Emails and attachments
  </Card>

  <Card title="Confluence" icon="confluence" href="/connectors/confluence">
    Pages, spaces, and attachments
  </Card>

  <Card title="Jira" icon="jira" href="/connectors/jira">
    Issues, epics, and comments
  </Card>

  <Card title="GitHub" icon="github" href="/connectors/github">
    Pull requests and issues
  </Card>

  <Card title="GitLab" icon="gitlab">
    Merge requests and issues
  </Card>

  <Card title="Notion" icon="book" href="/connectors/notion">
    Pages, databases, and wikis
  </Card>

  <Card title="Salesforce" icon="salesforce">
    Accounts, opportunities, and cases
  </Card>

  <Card title="HubSpot" icon="hubspot">
    Contacts, deals, and tickets
  </Card>

  <Card title="Zendesk" icon="headphones">
    Tickets and help articles
  </Card>

  <Card title="SharePoint" icon="microsoft">
    Sites, libraries, and pages
  </Card>

  <Card title="Linear" icon="layers">
    Issues and projects
  </Card>

  <Card title="Asana" icon="check-circle">
    Tasks and projects
  </Card>

  <Card title="And more" icon="plus">
    Airtable, Dropbox, Slab, Guru, and 25+ others
  </Card>
</CardGroup>

## Set up a connector

<Steps>
  <Step title="Go to Admin > Connectors">
    Open your Onyx instance and navigate to **Admin Panel** > **Connectors**.
  </Step>

  <Step title="Select a connector">
    Find the tool you want to connect and click it to open the setup form.
  </Step>

  <Step title="Authenticate">
    Depending on the connector, you'll authorize via OAuth (you'll be redirected to the source tool) or paste an API token or credentials directly.
  </Step>

  <Step title="Configure scope">
    Narrow down what gets indexed — specific channels, spaces, repos, or projects. Leave the scope fields empty to index everything the credential can access.
  </Step>

  <Step title="Save and wait for indexing">
    Click **Save**. Hadiq.io starts indexing immediately. Monitor progress on the connector's status page under Admin > Connectors.
  </Step>
</Steps>

## Permission syncing

Hadiq.io enforces the same access controls as the source system. When a user searches, they only see results from documents they have permission to access in the original tool.

For example, if a Google Drive file is restricted to the Finance team, only Finance team members will see it in Hadiq.io search results — even if the connector was set up by an admin with broader access.

Hadiq.io reads access control lists (ACLs) from each source and maps them to Hadiq.io users automatically. No manual permission configuration is needed.

<Note>
  Automatic per-document permission sync is available on the **Enterprise plan** and covers: Confluence, Jira, GitHub, Google Drive, Gmail, Slack, Salesforce, and SharePoint.
</Note>

On non-Enterprise plans, you can still restrict what gets indexed by scoping the connector to specific channels, spaces, or projects. This controls what content enters the index, but per-document ACL syncing is not applied.