Documentation / Publishing
How do I connect and publish to HubSpot?
HubSpot is a live publish adapter: TofuBofu writes finished articles as drafts you approve, then publishes them into your own CMS. This page covers connecting it, how we verify the connection, and what to do if it does not work the first time. For the full picture of every publish destination, see Integrations.
Connect
In HubSpot: Settings → Integrations → Private Apps → Create a private app. On the Scopes tab enable the CMS content read and write scopes, create the app, and copy the access token. Leave Blog ID blank to use your default blog. Blog publishing needs a Content Hub (CMS) plan.
| Field | What to enter |
|---|---|
| Private app access token | Settings → Integrations → Private Apps → your app → Auth |
| Blog ID (optional) (optional) | Leave blank to use your default blog |
Verify
TofuBofu asks your HubSpot account for its blog posts through the same API a publish would use. A green connection means the private app token was accepted with the CMS content scopes.
Troubleshoot
It says "That token was rejected".
Check you copied the full private app access token from Settings → Integrations → Private Apps → your app → Auth.
It says the token is missing CMS content scopes.
Edit the private app's Scopes tab, enable the CMS content read and write scopes, and generate a new token; scopes cannot be added to an existing token after the fact.
It says no blog was found.
Create a blog in HubSpot first, or paste its Blog ID when connecting. Blog publishing also requires a Content Hub (CMS) plan; a Marketing Hub-only account has no blog to publish into.