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

# HubSpot Knowledge Base

> The HubSpot Knowledge Base source pulls your published help articles into the AI's training index so answers cite your existing HubSpot content.

<Note>
  This page covers **HubSpot as a knowledge source** — syncing Knowledge Base articles into the AI's training index. For **operating HubSpot** (tickets, handoff, conversations, CRM context), see the [HubSpot integration](/integrations/hubspot/overview).
</Note>

The HubSpot Knowledge Base source pulls **published** articles from your HubSpot <Tooltip tip="HubSpot's Service Hub help-center product where you publish customer-facing knowledge articles.">Knowledge Base</Tooltip> into the AI's training index. OpenCX uses HubSpot **GraphQL Knowledge Base** access so synced articles include their full body content and source metadata.

## What you get

* **Published articles with full body content.** Whole-account sync today — no per-knowledge-base or per-category picker.
* **Drafts are not synced.** Only articles HubSpot reports as published are pulled. Draft, scheduled, and unpublished articles stay in HubSpot only.
* **Source URLs preserved.** Each synced article keeps its public HubSpot help-center URL so the AI can link back to it.
* **HubSpot metadata preserved.** Language, summary, publish/update timestamps, category ID, and access rule metadata are stored with the article.

## What's not supported today

* **Draft or unpublished articles.** Publish an article in HubSpot first, or use another source (manual upload, website crawler) for draft content.
* **Per-knowledge-base or per-category scoping.** The whole portal's published Knowledge Base collection is pulled. Use the [Website crawler](/knowledge/sources/website/overview) as a workaround if you only want a publicly reachable subset.
* **HubSpot accounts without Knowledge Base GraphQL.** The source requires HubSpot's latest Knowledge Base GraphQL support and a token with `cms.knowledge_base.articles.read`.

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Connect HubSpot Knowledge Base" icon="plug" href="/knowledge/sources/hubspot-kb/connect">
    Private App access token.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/knowledge/sources/hubspot-kb/troubleshooting">
    Auth errors, missing articles.
  </Card>

  <Card title="HubSpot integration" icon="hubspot" href="/integrations/hubspot/overview">
    Tickets, handoff, CRM context.
  </Card>

  <Card title="Connect a knowledge source" icon="brain" href="/knowledge/sources/overview">
    All sources.
  </Card>
</CardGroup>