Skip to main content
The HubSpot connector publishes posts to a blog in HubSpot Content Hub through the CMS Blog Posts API, with meta description, featured image and structured data filled in.

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.
  1. In HubSpot’s left navigation, click More → Development.
HubSpot left navigation with More open and Development highlighted

More → Development

  1. In the Development sidebar, open Keys → Service Keys and click Create service key.
HubSpot Development page with Service Keys selected in the sidebar and the Create service key button highlighted

Development → Keys → Service Keys → Create service key

  1. Name it SEO Sorted, then click Add new scope.
Create Service Key page with the name SEO Sorted and the Add new scope button highlighted

Name the key and add a scope

  1. Search for content, tick it, and click Update.
Add new scope panel filtered to content, with content ticked and the Update button highlighted

Tick the content scope

  1. Click Create in the top right, then Create again to confirm.
Create Service Key page with the content scope selected and the Create button highlighted

Create the key

  1. On the key’s page, click Copy next to the service key. It starts with pat-.
SEO Sorted service key page with the key hidden and the Copy link highlighted

Copy the service key

The key acts with its scopes, not as a person. Anyone who has it can edit your blog, so paste it only into SEO Sorted and don’t share it.

Step 2 — Connect in SEO Sorted

Project Settings → Integrations → HubSpot → Connect.
Connect HubSpot dialog with setup steps and an Access token field

The HubSpot connect form

string
required
The service key from step 1 (or a private app access token), starting with pat- (e.g. pat-na2-…). Stored encrypted.
We read your blogs with the token before saving. If you have more than one blog, we pick the one whose address matches your project’s website, or the first one otherwise. To change it, open the HubSpot card’s ⋮ menu → Configure and choose another blog.

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

The key was rotated, deleted or copied incompletely. Open Development → Keys → Service Keys → SEO Sorted, click Copy and reconnect.
Open the key → Edit, add the content scope, save, and connect again.
Open Content → Blog. If HubSpot offers “Start from scratch”, click it once to create the blog, then connect again.
The value is too short to be a key. Use Copy on the key’s page rather than selecting the text by hand.
HubSpot no longer lets new accounts create private apps. Use a service key (step 1) instead.