Skip to main content
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.
The HubSpot Knowledge Base source pulls published articles from your HubSpot 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 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.

Connect HubSpot Knowledge Base

Private App access token.

Troubleshooting

Auth errors, missing articles.

HubSpot integration

Tickets, handoff, CRM context.

Connect a knowledge source

All sources.