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

# Knowledge Connectors

> Import and synchronize documentation from external platforms

Knowledge connectors import and synchronize documentation from external platforms into AGO. Your AI agents can then use this content to provide accurate, up-to-date answers based on your existing documentation.

AGO supports **19 connector types** across different categories: help centers, wikis, developer docs, media, and file-based imports.

## Connector Comparison

### Help Center & Support Platforms

| Feature                | Zendesk     | Intercom    | HelpScout   | Crisp       | Smart Tribune      | HubSpot KB        |
| ---------------------- | ----------- | ----------- | ----------- | ----------- | ------------------ | ----------------- |
| **Authentication**     | API Token   | API Token   | API Key     | API Token   | Bearer Token       | Private App Token |
| **Content Type**       | Help Center | Help Center | Help Center | Help Center | FAQ/Knowledge Base | Knowledge Base    |
| **Multi-language**     | Yes         | Yes         | Yes         | Yes         | Yes                | No                |
| **Hierarchy Support**  | Yes         | Yes         | Yes         | Yes         | Yes                | Yes               |
| **Filter by Category** | Yes         | Yes         | Yes         | Yes         | Yes                | Yes               |

### Wiki & Documentation Platforms

| Feature               | Notion            | Confluence      | Paligo         | README   | Mintlify          |
| --------------------- | ----------------- | --------------- | -------------- | -------- | ----------------- |
| **Authentication**    | OAuth / API Token | API Token       | File Import    | API Key  | None (Web Scrape) |
| **Content Type**      | Wiki/Database     | Enterprise Wiki | Technical Docs | API Docs | Developer Docs    |
| **Multi-language**    | No                | Yes             | Yes            | No       | No                |
| **Hierarchy Support** | Yes               | Yes             | Yes            | Yes      | Yes               |
| **Attachments**       | Yes               | Yes             | Yes            | Yes      | Yes               |

### Data & File-Based Sources

| Feature               | Airtable        | JSON           | Qualios            | OpenAPI           | MadCap            |
| --------------------- | --------------- | -------------- | ------------------ | ----------------- | ----------------- |
| **Authentication**    | API Key         | None           | API Key            | None              | None              |
| **Content Type**      | Structured Data | Custom JSON    | Quality Docs       | API Specs         | Technical Docs    |
| **Hierarchy Support** | Tables          | Custom         | Yes                | Auto-generated    | Yes               |
| **Best For**          | Structured data | Custom imports | Quality management | API documentation | Technical writers |

## Available Knowledge Connectors

AGO supports 19 connector types for importing documentation from various sources.

### Help Center Connectors

<CardGroup cols={2}>
  <Card title="Zendesk Integration" icon="headset" href="/data-connector/zendesk-integration">
    Import knowledge base articles from Zendesk Help Center with multi-language support and category filtering.
  </Card>

  <Card title="Intercom Integration" icon="comments" href="/data-connector/intercom-integration">
    Synchronize help center articles from Intercom, including collections, sections, and multi-language content.
  </Card>

  <Card title="HelpScout Integration" icon="life-ring" href="/data-connector/helpscout-knowledge-integration">
    Import knowledge base articles and categories from HelpScout Docs.
  </Card>

  <Card title="Crisp Integration" icon="comment-dots" href="/data-connector/crisp-integration">
    Import help center content from Crisp with hierarchical category and section filtering.
  </Card>

  <Card title="Smart Tribune Integration" icon="lightbulb" href="/data-connector/smart-tribune-integration">
    Import FAQ and knowledge base content from Smart Tribune with thematic filtering.
  </Card>

  <Card title="HubSpot Knowledge Base Integration" icon="hubspot" href="/data-connector/hubspot-kb-integration">
    Import articles from HubSpot Service Hub Knowledge Base with state filtering and category organization.
  </Card>
</CardGroup>

### Wiki & Documentation Connectors

<CardGroup cols={2}>
  <Card title="Notion Integration" icon="file-lines" href="/data-connector/notion-integration">
    Import Notion workspace pages and databases with OAuth authentication and property-based filtering.
  </Card>

  <Card title="Confluence Integration" icon="atlas" href="/data-connector/confluence-integration">
    Connect to Atlassian Confluence for enterprise wiki import with hierarchical structure and attachments.
  </Card>

  <Card title="Paligo Integration" icon="book" href="/data-connector/paligo-integration">
    Import topic-based technical documentation from Paligo CCMS with multi-language support.
  </Card>

  <Card title="README Integration" icon="readme" href="/data-connector/readme-integration">
    Import developer documentation, API references, and changelogs from README.io.
  </Card>

  <Card title="Mintlify Integration" icon="leaf" href="/data-connector/mintlify-integration">
    Import documentation from Mintlify-powered sites via web scraping with automatic hierarchy detection.
  </Card>
</CardGroup>

### Data & File-Based Connectors

<CardGroup cols={2}>
  <Card title="Airtable Integration" icon="table" href="/data-connector/airtable-integration">
    Import structured data from Airtable bases with custom field mapping and linked field support.
  </Card>

  <Card title="JSON Integration" icon="brackets-curly" href="/data-connector/json-integration">
    Import documents from JSON files with custom title, content, and ID field mapping.
  </Card>

  <Card title="Qualios Integration" icon="clipboard-check" href="/data-connector/qualios-integration">
    Import quality management documentation from Qualios with status filtering.
  </Card>

  <Card title="OpenAPI Integration" icon="code" href="/data-connector/openapi-integration">
    Generate API reference documentation from OpenAPI specifications automatically.
  </Card>

  <Card title="MadCap Integration" icon="book-open" href="/data-connector/madcap-integration">
    Import technical documentation from MadCap Flare projects with table of contents support.
  </Card>
</CardGroup>

### Media Connectors

<CardGroup cols={2}>
  <Card title="YouTube Playlist Integration" icon="youtube" href="/data-connector/youtube-playlist-integration">
    Import content from YouTube playlists as knowledge documents, one per video.
  </Card>

  <Card title="XML Import Integration" icon="file-code" href="/data-connector/xml-integration">
    Import and convert XML feeds into structured knowledge documents with configurable field mapping.
  </Card>
</CardGroup>

### Special Source Types

<CardGroup cols={2}>
  <Card title="Manual/AGO Source" icon="pen-to-square">
    Create and manage documents directly in AGO with PDF upload support — no external import needed.
  </Card>

  <Card title="Folder Source" icon="folder-tree">
    Organize multiple sources into logical groups for navigation — container only, no direct content.
  </Card>
</CardGroup>

## How Knowledge Connectors Work

```mermaid theme={null}
flowchart LR
    A[External Source] --> B[Connector]
    B --> C[Content Fetch]
    C --> D[Markdown Conversion]
    D --> E[Document Storage]
    E --> F[Vector Indexing]
    F --> G[AI Search Ready]
```

1. **Configuration**: Set up credentials and specify what content to import
2. **Fetch**: Connector retrieves content from the external platform's API
3. **Convert**: HTML and rich text are converted to Markdown
4. **Store**: Documents are saved with metadata and hierarchy
5. **Index**: Content is vectorized for semantic search
6. **Sync**: Scheduled updates keep content fresh

## Choosing a Connector

| Use Case                        | Recommended Connectors                          |
| ------------------------------- | ----------------------------------------------- |
| Customer support knowledge base | Zendesk, Intercom, HelpScout, Crisp, HubSpot KB |
| Team wikis and internal docs    | Notion, Confluence                              |
| Technical documentation         | Paligo, MadCap, README                          |
| Developer/API documentation     | README, Mintlify, OpenAPI                       |
| Video content                   | YouTube Playlist                                |
| Structured data                 | Airtable, JSON, XML-to-JSON                     |
| Quality management              | Qualios                                         |
| Custom content                  | Manual/AGO, JSON                                |

## Authentication Methods

| Method                | Connectors                    | Notes                                    |
| --------------------- | ----------------------------- | ---------------------------------------- |
| **OAuth 2.0**         | Notion                        | Most secure, auto-refresh tokens         |
| **Private App Token** | HubSpot KB                    | Stored encrypted                         |
| **API Key/Token**     | Most connectors               | Stored encrypted                         |
| **File Upload**       | Paligo, JSON, OpenAPI, MadCap | No credentials needed                    |
| **Web Scraping**      | Mintlify                      | No authentication                        |
| **API Key (Google)**  | YouTube Playlist              | YouTube Data API key                     |
| **URL Fetch**         | XML-to-JSON                   | No credentials needed (fetches from URL) |

## Getting Started

1. **Choose connector**: Select based on your documentation platform
2. **Gather credentials**: Obtain API keys or set up OAuth
3. **Create source**: Navigate to Knowledge → Sources → Create
4. **Configure settings**: Set source ID, filters, and options
5. **Test sync**: Run a manual sync to verify import
6. **Schedule**: Configure auto-sync for regular updates

## Best Practices

### Content Organization

* Start with a subset of content before full import
* Use restricted keywords to filter sensitive content
* Organize sources into folders for large knowledge bases

### Sync Strategy

* Set appropriate sync frequency based on content update rate
* Use daily sync for stable documentation
* Use more frequent sync for rapidly changing content

### Quality Assurance

* Review imported documents for formatting issues
* Test search to verify documents are findable
* Monitor sync history for errors

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Errors">
    **API Token Invalid**

    * Verify the token hasn't expired
    * Check token has required permissions/scopes
    * Regenerate token if needed

    **OAuth Connection Failed (Notion)**

    * Re-authorize the connection
    * Ensure workspace permissions are granted
    * Check integration has access to target pages
  </Accordion>

  <Accordion title="Sync Issues">
    **Sync Stuck in Progress**

    * Reset sync status in admin panel
    * Check for rate limiting from external service
    * Verify network connectivity

    **Documents Missing After Sync**

    * Check restricted keywords aren't filtering content
    * Verify source ID/page ID is correct
    * Ensure connector has access to the content
    * Check for empty or draft documents being skipped

    **Content Not Updated**

    * Trigger manual sync to force refresh
    * Check last\_sync\_at timestamp
    * Verify auto-sync is enabled and scheduled
  </Accordion>

  <Accordion title="Content Quality">
    **Formatting Issues**

    * HTML conversion may lose some formatting
    * Complex tables may need manual adjustment
    * Code blocks should preserve syntax

    **Missing Images**

    * Some connectors don't import images
    * Check attachment settings for the connector
    * External images may need accessible URLs

    ***
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={3}>
  <Card title="Knowledge Source Management" icon="gear" href="/features/knowledge-source-management">
    Managing sources
  </Card>

  <Card title="Knowledge Overview" icon="book-open" href="/features/knowledge-overview">
    Feature overview
  </Card>

  <Card title="Set Up Your Knowledge Base" icon="graduation-cap" href="/guides/knowledge-setup-tutorial">
    Setup tutorial
  </Card>
</CardGroup>