> For a complete page index of the Captain API documentation, fetch https://docs.runcaptain.com/llms.txt?excludeSpec=true

# Integrations

> Captain connects to 20+ data sources via Indexed Search (S3, GCS, Azure, Google Drive, SharePoint, Notion, Dropbox, Snowflake) and Live Search (Slack, Linear, Jira, Confluence, Gmail, HubSpot, NetSuite).

## Agent Quick Reference - Integrations

### Indexed Search (files processed into searchable chunks)

* **Via API**: Amazon S3, Google Cloud Storage, Azure Blob Storage, Cloudflare R2
* **Via Studio UI**: Google Drive, SharePoint, OneDrive, Dropbox, Notion, Snowflake (stage files)
* Query via: `POST /v2/collections/{name}/query`

### Live Search (real-time queries, no indexing)

* Snowflake (SQL), Slack, Linear, Jira, Confluence, Asana, Gmail, Google Calendar, HubSpot, Oracle NetSuite
* Connected via Captain Studio credentials/OAuth. Queried via Studio chat interface.

### Environment scoping

* `cap_dev_*` = development, `cap_stage_*` = staging, `cap_prod_*` = production
* Collections are isolated by environment. Use `PATCH /v2/collections/{name}/environment` to promote without reindexing.

Captain connects to your data wherever it lives. There are two ways Captain searches your data. **Indexed Search** and **Live Search**. and some integrations support both.

## Search Types

### Indexed Search

Files are uploaded to cloud storage (S3, GCS, Azure), then processed by Captain's RAG engine. Documents are chunked, embedded, and stored for fast semantic search across large volumes of unstructured data.

**Best for:** Documents, knowledge bases, archival data, spreadsheets, presentations, and any files you want to search semantically.

**How it works:**

1. Upload files to S3, GCS, or Azure. or use the Captain Studio to connect Google Drive, SharePoint, Notion, Dropbox, or OneDrive
2. Call the indexing API (or let the Studio handle it) to process files into searchable chunks
3. Query the collection. Captain retrieves relevant chunks and optionally generates an AI response

### Live Search

Real-time queries against connected services. No indexing step. results come directly from the source API at query time, always reflecting the current state of the data.

**Best for:** Messages, issues, tasks, emails, calendar events, and live database queries where freshness matters.

**How it works:**

1. Connect the integration via Captain Studio (credentials or OAuth)
2. Ask questions in the chat interface. Captain's agent calls the service API in real-time
3. Results are always up-to-date

***

## Indexed Search Integrations

Index files from cloud storage providers via the API, or connect SaaS platforms through the Captain Studio.

### Cloud Storage (API)

### SaaS Platforms (Studio)

***

## Live Search Integrations

Real-time queries against connected services. Connect via Captain Studio. no indexing required.

[Setup Guide →](/integrations/live-search-guides/oracle-net-suite)

***

## Quick Reference

| Integration                                                              | Live Search      | Indexed Search    | Auth                   | Notes                                                                                                                       |
| ------------------------------------------------------------------------ | ---------------- | ----------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Amazon S3**                                                            | .                | Yes               | Access Key + Secret    | API: Full bucket, single file, or directory                                                                                 |
| **Google Cloud Storage**                                                 | .                | Yes               | Service Account JSON   | API: Full bucket, single file, or directory                                                                                 |
| **Azure Blob Storage**                                                   | .                | Yes               | Account Name + Key     | API: Full container, single blob, or directory                                                                              |
| **Google Drive**                                                         | .                | Yes               | OAuth (per-user)       | Studio: File picker UI                                                                                                      |
| **SharePoint**                                                           | .                | Yes               | OAuth (per-user)       | Studio: File picker UI                                                                                                      |
| **OneDrive**                                                             | .                | Yes               | MSAL (per-user)        | Studio: File picker UI                                                                                                      |
| **Dropbox**                                                              | .                | Yes               | OAuth (per-user)       | Studio: File picker UI                                                                                                      |
| **Notion**                                                               | .                | Yes               | OAuth (per-user)       | Studio: Page picker, markdown conversion                                                                                    |
| **Snowflake**                                                            | Yes (SQL search) | Yes (stage files) | Credentials (org-wide) | **Live:** Real-time SQL queries against your warehouse. **Indexed:** Index files from Snowflake stages for semantic search. |
| **Slack**                                                                | Yes              | .                 | OAuth (per-user)       | Message search with channel/user/date filters                                                                               |
| **Linear**                                                               | Yes              | .                 | API Key (org-wide)     | Issue search, cycle tracking, status updates                                                                                |
| **Jira**                                                                 | Yes              | .                 | API Token (org-wide)   | Issue search via JQL filters                                                                                                |
| **Confluence**                                                           | Yes              | .                 | API Token (org-wide)   | Page search via CQL                                                                                                         |
| **Asana**                                                                | Yes              | .                 | OAuth (per-user)       | Task search with project filtering                                                                                          |
| **Gmail**                                                                | Yes              | .                 | OAuth (per-user)       | Email search                                                                                                                |
| **Google Calendar**                                                      | Yes              | .                 | OAuth (per-user)       | Event listing with date range filters                                                                                       |
| **HubSpot**                                                              | Yes              | .                 | OAuth (per-user)       | CRM search: contacts, companies, deals, tickets                                                                             |
| **[Oracle NetSuite](/integrations/live-search-guides/oracle-net-suite)** | Yes              | .                 | OAuth (per-user)       | ERP: records, SuiteQL queries, financial reports                                                                            |

***

## Getting Data into Collections

### Via API (Indexed Search)

Use the indexing endpoints to process files directly from cloud storage:

* `POST /v2/collections/{name}/index/s3`. Index from AWS S3
* `POST /v2/collections/{name}/index/gcs`. Index from Google Cloud Storage
* `POST /v2/collections/{name}/index/azure`. Index from Azure Blob Storage
* `POST /v2/collections/{name}/index/r2`. Index from Cloudflare R2

Each endpoint supports full bucket/container indexing, single file indexing, and directory-scoped indexing. See the <a href="/quickstart" target="_blank">Quickstart</a> for step-by-step examples.

### Via Captain Studio (Indexed Search)

Use the web UI at [runcaptain.com/studio](https://runcaptain.com/studio) to connect cloud and SaaS sources:

* **Google Drive**. Browse and select files or folders
* **SharePoint / OneDrive**. Browse and select documents from sites and libraries
* **Dropbox**. Browse and select files
* **Notion**. Select pages and databases (automatically converted to markdown)
* **Snowflake**. Index files from Snowflake stages

Files are automatically uploaded to cloud storage and indexed by Captain.

### Via Captain Studio (Live Search)

Connect credentials in the Studio for real-time search. no indexing required:

* **Snowflake**. Account, username, password, warehouse, role
* **Linear**. Personal API key (does not expire)
* **Jira / Confluence**. API token + user email + Atlassian cloud ID
* **Slack**. OAuth authorization per user
* **Asana**. OAuth authorization per user
* **Gmail / Google Calendar**. OAuth authorization per user
* **HubSpot**. OAuth authorization per user
* **Oracle NetSuite**. OAuth authorization per user (requires [admin setup](/integrations/live-search-guides/oracle-net-suite#prerequisites))

***

## Environment Scoping

All collections and API keys are scoped to an environment:

* **Development** (`cap_dev_*`). For testing and development
* **Staging** (`cap_stage_*`). For pre-production testing
* **Production** (`cap_prod_*`). For production use

Collections created with a development key can only be accessed with development keys from the same organization. Use the <a href="/api-reference/api-reference/collections/change-collection-environment-v-2" target="_blank">Change Collection Environment</a> endpoint to promote a collection from development to production without reindexing.