Before you start
- Your blog has to be hosted on HubSpot. If you use HubSpot as your CRM but run your blog on WordPress, Webflow or Framer, connect that platform instead. Landing pages and site pages aren’t supported.
- The blog needs to exist and have at least one author. On a new portal, go to Content → Blog and start a post to create the blog, then add an author under Content → Blog → Configure → Authors → Add new author.
- Creating a private app takes a HubSpot Super Admin.
Setup
Step 1: Create a legacy private app in HubSpot
- In HubSpot, click the settings gear icon in the top navigation.
- Go to Integrations → Private Apps.
- On the Your private apps have moved screen, click Go to Legacy Apps.
- Click Create legacy app → Private.
- Acknowledge HubSpot’s legacy-app notice and click Continue with legacy private app.
- On the Basic Info tab, give it a name you’ll recognise, such as “ChatFeatured”.
Step 2: Select the scope
- Open the Scopes tab.
- Click Add new scope, search for and select
content, then click Update. - Click Create app, then Continue creating.
content is the only scope you need.
Step 3: Copy the access token
- Open the Auth tab of the app.
- Click Show token, then Copy. The token starts with
pat-.
Step 4: Connect in ChatFeatured
- Go to Integrations → HubSpot.
- Paste the token into Private app token and click Connect.
- Pick the Blog you want to publish to.
- Pick a Default author. HubSpot won’t publish a post without one.
- Click Connect blog.
Publishing an article
In the article editor, click Publish or Schedule and choose your HubSpot blog. The Publish to HubSpot dialog has:
Publish Now and Schedule need an author and a meta description (or an excerpt to fall back on). Save as Draft needs neither.
What gets sent
What happens when you publish, update, unpublish, schedule
Once an article is published, the editor shows View In HubSpot instead of Publish. To change the post, open the article’s menu in the Articles list and choose Unpublish, edit the article, then publish it again. The same HubSpot post is updated.
Once a post is live, ChatFeatured records its HubSpot URL and starts attributing AI citations of that page to the article.
Troubleshooting
HubSpot denied access to the blog API
HubSpot denied access to the blog API
The private app may be missing the
content scope, or your HubSpot subscription may not include the Blog API. To check the scope, in HubSpot go to Settings → Integrations → Private Apps → Go to Legacy Apps, open your app, and confirm content is selected on the Scopes tab.HubSpot rejected the private app token
HubSpot rejected the private app token
The token was rotated or the app was deleted in HubSpot. Create a new token, or a new private app, following the setup steps above, then connect again with it.
HubSpot requires a meta description to publish
HubSpot requires a meta description to publish
The article has neither a meta description nor an excerpt. Add one in ChatFeatured and publish again.
Related
All integrations
Every CMS and analytics integration ChatFeatured supports.
Articles
How articles move from idea to published.

