How to Connect Your HubSpot Account to SEOmatic

Written By Minh

Last updated 1 day ago

Minimum Requirements

  • A HubSpot account with CMS Hub (Blog feature enabled)

  • Super admin access to your HubSpot account

Creating Your Private App

Before connecting, you need to create a private app in HubSpot.

  1. Log in to your HubSpot account and click the Settings icon in the top navigation bar.

  2. In the left sidebar, go to Integrations > Private Apps.

  3. Click "Create a private app" and name it (e.g. "SEOmatic").

  4. Go to the Scopes tab and enable CMS > Blog (Read and Write).

  5. Click "Create app" and confirm.

  6. On the Auth tab, click "Show token" and copy your access token. Save it somewhere secure.

Step 1: Go to Connections

In your SEOmatic dashboard, go to Connections from the sidebar (or click the "Missing connection" warning in the header if you see one).

Step 2: Enter Your Access Token

Click Connect HubSpot and paste your Private App Access Token.

SEOmatic will automatically validate your token as you type.

Click Connect.

Step 3: You're Connected

On the Connections page, you should now see your HubSpot account listed with a green "active" status - that means you're connected and ready to publish.

Troubleshooting

Problem

Solution

Invalid access token

Make sure you copied the full token from your private app's Auth tab. Go to HubSpot Settings > Integrations > Private Apps, select your app, and copy it again.

Insufficient permissions

Your private app is missing the Blog scope. Go to your private app settings in HubSpot, open the Scopes tab, enable CMS > Blog (Read and Write), and save.

No blogs found in your HubSpot account

You need at least one blog created in HubSpot before you can publish. Create a blog in your HubSpot CMS first, then try again.

Connection timed out

The HubSpot API took too long to respond. Try again in a few minutes.

Private apps aren't available

You may be using a HubSpot developer account instead of a regular portal. Private apps must be created from a standard HubSpot account, not a developer account.