Before you start
- A HubSpot account with a blog. The free plan includes one. If Content → Blog shows “Grow your audience with your first blog post”, click Start from scratch once — HubSpot creates the blog. You can close the editor without publishing anything.
- Super Admin permission in that account — only Super Admins can create keys.
Step 1 — Create a service key in HubSpot
HubSpot has replaced private apps with service keys. Accounts created recently can only use service keys; older accounts that still have a private app can use its access token instead — it works the same way.- In HubSpot’s left navigation, click More → Development.

More → Development
- In the Development sidebar, open Keys → Service Keys and click Create service key.

Development → Keys → Service Keys → Create service key
- Name it SEO Sorted, then click Add new scope.

Name the key and add a scope
- Search for
content, tick it, and click Update.

Tick the content scope
- Click Create in the top right, then Create again to confirm.

Create the key
- On the key’s page, click Copy next to the service key. It starts with
pat-.

Copy the service key
Step 2 — Connect in SEO Sorted
Project Settings → Integrations → HubSpot → Connect.
The HubSpot connect form
The service key from step 1 (or a private app access token), starting with
pat- (e.g.
pat-na2-…). Stored encrypted.Step 3 — Publish
Open an article, click Publish, then Publish now next to HubSpot. The dialog confirms Article Published — “Successfully published to your HubSpot blog” — with a View article button for the live post.What gets published
Posts are created published.Re-publishing, unpublishing and deleting
- Re-publish updates the same post in place. If it was deleted in HubSpot, a new one is created.
- Unpublish sets the post back to Draft.
- After an unpublish, SEO Sorted forgets the post. Publishing the article again creates a new HubSpot post; the earlier draft stays in HubSpot.
- Deleting the article in SEO Sorted deletes the HubSpot post.
Tracking AI crawlers
HubSpot supports Cloudflare in front of its hosting only on a Cloudflare Enterprise plan, so AI crawler tracking needs one. With Enterprise, see HubSpot CMS in the tracking guide.Common problems
“HubSpot rejected that access token…”
“HubSpot rejected that access token…”
The key was rotated, deleted or copied incompletely. Open Development → Keys → Service
Keys → SEO Sorted, click Copy and reconnect.
“That key is missing the content scope…”
“That key is missing the content scope…”
Open the key → Edit, add the
content scope, save, and connect again.“No blog found in this HubSpot account…”
“No blog found in this HubSpot account…”
Open Content → Blog. If HubSpot offers “Start from scratch”, click it once to create the
blog, then connect again.
“Paste your HubSpot service key.”
“Paste your HubSpot service key.”
The value is too short to be a key. Use Copy on the key’s page rather than selecting the
text by hand.
“Legacy apps aren't available on this account”
“Legacy apps aren't available on this account”
HubSpot no longer lets new accounts create private apps. Use a service key (step 1) instead.
Styling looks different from my other posts
Styling looks different from my other posts
HubSpot applies your blog template’s CSS to the body. If headings or tables look off, adjust
the blog post template’s styles in the HubSpot design manager.

