aeoo
All docs

Docs · Publishing

Connect HubSpot

Connect a HubSpot site once, and approved titles, descriptions, structured data and blog posts go live by themselves. It takes one private app token.

Before you start

You need to be an admin in aeoo, and able to create a private app in the HubSpot account that runs the site. aeoo shows HubSpot under Publishing when the site’s platform is HubSpot; it spots that when you add the site.

1Create a private app in HubSpot

In HubSpot, open Settings, then Integrations, then Private apps, and create a private app. Name it after your agency. Under Scopes, tick content, then create it.

2Paste its token in aeoo

In aeoo, open the client’s Settings, then Publishing. Copy the private app’s access token, paste it in the HubSpot row and choose Connect HubSpot. aeoo checks that the token can see the site’s pages, then shows Connected. The token is stored encrypted, and nobody can read it back.

What goes live by itself

Titles and descriptions
On site pages, landing pages and blog posts.
Structured data
In the page’s head HTML, in a block of its own that aeoo replaces, never doubles.
Blog posts
Into the site’s blog, when aeoo found one. New blog posts go to shows which blog. Posts go up without a featured image.
New sections inside a page
Ready to paste, marked By hand. HubSpot pages are built from modules that differ per theme.

An approved change goes live by itself when its approval rule says Publishes when approved. Otherwise choose Publish the N under To do’s In progress view. Changes HubSpot can’t take are covered in Publish by hand.

When a change waits

aeoo writes to a page’s draft and pushes it live, so only its own field changes. If the page has edits in HubSpot that aren’t published yet, the change waits, so nobody’s unfinished work goes live with it. Once those edits are published or discarded, it goes out within a few minutes.

If the token is refused

  • HubSpot didn’t accept that token: copy it again from the private app.
  • The private app needs the content scope: add it, then copy the token again.
  • That token can’t see any pages on the site: create the private app in the HubSpot account that runs this site.

Disconnect stops publishing; approved changes are then copied in by hand. A change aeoo published can be put back with Revert a change.

Was this helpful?

Updated 12 November 2026