Help

HubSpot Integration

Connect BlogSEO to your HubSpot blog to automatically publish AI-generated articles, complete with SEO metadata, featured images, tags, and authors.

The HubSpot integration uses a secure OAuth connection, so there are no API keys to copy or paste. Once connected, BlogSEO can publish to your HubSpot blog automatically or on demand, and keep already-published articles in sync.

Connecting your HubSpot account

  1. In your BlogSEO dashboard, open Integrations → HubSpot.

  2. Click Connect HubSpot. You'll be redirected to HubSpot to authorize BlogSEO.

  3. Choose the HubSpot account (portal) you want to connect and approve the requested permissions.

  4. You'll be sent back to BlogSEO. If your portal has more than one blog, you'll be asked to pick which blog BlogSEO should publish to.

That's it, your HubSpot blog is connected.

BlogSEO connects to one HubSpot blog per workspace. If your portal hosts several blogs, you choose the target blog during setup.

Auto-publishing and drafts

From the HubSpot integration page you control how articles reach HubSpot:

  • Auto-publish, when enabled, BlogSEO publishes new articles to your HubSpot blog automatically as they're generated. With it off, nothing is published until you push it manually.
  • Publish in draft, when auto-publish is on, you can choose whether articles go out live (the default) or are saved as drafts in HubSpot so you can review them before they go live.

Publishing an article manually

If you'd rather keep auto-publish off, you can still push any article to HubSpot whenever you want. Open the article in BlogSEO and click Publish → Publish to HubSpot from its preview. The article is created on your HubSpot blog with its title, body, meta description, featured image, and any tags or author you've configured.

Keeping articles in sync

Edited an article after it was published? Update it in BlogSEO and click Sync to CMS from the article preview. BlogSEO updates the existing HubSpot post in place (rather than creating a duplicate) and pushes your changes live. You can also jump to the post at any time with the See on HubSpot button on the article preview.

Syncing is one-way — BlogSEO pushes your changes to HubSpot but never reads them back. Edits you make directly in HubSpot won't show up in BlogSEO, and because Sync to CMS replaces the HubSpot post's content with BlogSEO's version, those direct edits are overwritten the next time you sync. Edit each article in one place: in BlogSEO if you plan to keep syncing, or in HubSpot once you're done syncing it.

Tags and author

By default, BlogSEO is set to Let AI decide for both the blog author and tags. When publishing, it looks at your existing HubSpot authors and tags and picks the most relevant ones for each article, with no setup required.

If you'd rather pin a specific author or a fixed set of tags, click Update Configuration on the HubSpot integration page and choose them in the dialog. Under Advanced Settings you can also add free-text field mapping instructions to steer how the AI fills in fields, for example "Use the Marketing author for product launches, and tag pricing posts with 'pricing'." Leave it empty to keep the default behavior.

Multiple languages

If your website is set up for multiple languages and your HubSpot blog has the matching language variations enabled, BlogSEO publishes each translation as a HubSpot language variation linked to the primary post, mapped to the right language automatically.

HubSpot's multi-language blog posts require Marketing Hub or Content Hub Professional (or higher), and the target languages must already be enabled on your HubSpot blog. Any language your blog doesn't support is skipped automatically, and your primary-language article still publishes normally.

Frequently Asked Questions

Do I need a HubSpot API key? No. BlogSEO connects to HubSpot through a secure OAuth flow. You authorize the connection once from HubSpot and never have to handle API keys.

Can I publish to a specific HubSpot blog? Yes. If your portal has more than one blog, you choose the target blog when you connect, and BlogSEO publishes every article to that blog.

Will my featured and inline images have alt text? Yes. BlogSEO sets alt text on the featured image and fills in any missing alt text on inline images automatically, so your posts stay accessible and SEO-friendly.

Can I edit an article in HubSpot after publishing? Yes, but syncing is one-way. Edit it directly in HubSpot, or update it in BlogSEO and click Sync to CMS to push the changes to the same post — just note that BlogSEO never pulls HubSpot edits back, and a later Sync to CMS overwrites the HubSpot post with BlogSEO's version. Edit in one place to avoid losing changes.

Does BlogSEO support HubSpot drafts? Yes. Turn on Publish in draft and your articles are saved as drafts in HubSpot for review before they go live.

Was this page helpful?