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

# Connectors - Overview

> Quick reference for all connector endpoints, their lifecycle, and when to call each.

Connectors continuously sync external app data (Slack, GitHub, Linear, Notion, Gmail) into your knowledge store without manual ingestion. See the [Connectors guide](/essentials/v2/connectors) for a full walkthrough.

## Endpoint references

| Endpoint                                                                                         | Method   | Purpose                                        |
| ------------------------------------------------------------------------------------------------ | -------- | ---------------------------------------------- |
| [`/connectors`](/api-reference/v2/endpoint/create-connector)                                     | `POST`   | Create a new connector                         |
| [`/connectors`](/api-reference/v2/endpoint/list-connectors)                                      | `GET`    | List all connectors for the organization       |
| [`/connectors/:id`](/api-reference/v2/endpoint/get-connector)                                    | `GET`    | Get a single connector                         |
| [`/connectors/:id`](/api-reference/v2/endpoint/delete-connector)                                 | `DELETE` | Delete a connector                             |
| [`/connectors/:id/discover`](/api-reference/v2/endpoint/discover-connector-resources)            | `GET`    | List available resources from the provider     |
| [`/connectors/:id/configure`](/api-reference/v2/endpoint/configure-connector)                    | `POST`   | Activate resources and set sync options        |
| [`/connectors/:id/sync`](/api-reference/v2/endpoint/sync-connector)                              | `POST`   | Trigger an on-demand sync                      |
| [`/connectors/:id/resources`](/api-reference/v2/endpoint/connector-resources)                    | `GET`    | List configured resources and their sync state |
| [`/connectors/:id/resources`](/api-reference/v2/endpoint/add-connector-resource)                 | `POST`   | Add an individual resource row                 |
| [`/connectors/:id/resources/:resource_id`](/api-reference/v2/endpoint/delete-connector-resource) | `DELETE` | Remove a resource                              |

## Typical call sequence

```text theme={"dark"}
POST /connectors                     -> create connector with credentials
GET  /connectors/:id/discover        -> inspect what resources are available
POST /connectors/:id/configure       -> activate resources, set lookback_days
POST /connectors/:id/sync            -> trigger first sync (optional; scheduler runs hourly)
GET  /connectors/:id/resources       -> poll until provider_cursor is set (sync ran)
POST /query  (query_apps: true)      -> search synced data
DELETE /connectors/:id               -> teardown
```

## Authentication

All connector endpoints use your HydraDB API key:

```bash theme={"dark"}
Authorization: Bearer $HYDRA_DB_API_KEY
API-Version: 2
```

## Key concepts

* **Connector**  -  An authenticated connection to one external provider account. A single connector manages all resources synced from that account.
* **Resource**  -  A syncable unit within a provider: a Slack channel, GitHub repo, Linear team/project, Notion database/page, or Gmail label. You activate resources individually via `/configure`.
* **Cursor**  -  A per-resource bookmark of the last synced position. Sync is incremental: only content newer than the cursor is fetched on each run.
* **provider\_account\_scope**  -  An identifier for the external account (e.g. Slack workspace ID, GitHub org). Used as part of the deduplication key  -  two connectors for the same provider must have distinct `provider_account_scope` values.