Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trysight.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The HubSpot integration lets Sight AI publish articles directly to your HubSpot CMS blog using HubSpot’s secure OAuth flow — no API keys to copy around. Connect once, pick a default blog, author, tags, and publish state, and every article Sight AI generates can be pushed to HubSpot as a Draft or Published post.

​
Requirements

  • HubSpot account — Content Hub Professional/Enterprise or Marketing Hub Professional/Enterprise (the content scope is gated to these tiers)
  • At least one blog — Set up under Marketing → Website → Blog in HubSpot
  • HubSpot admin access — Required to install third-party apps in your portal
  • Sight AI workspace — Owner or admin role on the team that owns the site

​
How it works

Sight AI uses HubSpot’s new developer-platform OAuth flow (CLI-built apps, platform version 2026.03). When you click Connect HubSpot, you’ll be redirected to HubSpot to authorize the Sight AI app to read your blogs, authors, and tags, and to create and update blog posts. We never see your HubSpot password; HubSpot returns short-lived access tokens that we refresh automatically. Behind the scenes:
  1. We exchange the authorization code for an access + refresh token at api.hubapi.com/oauth/v1/token.
  2. Both tokens are AES-256-GCM encrypted at rest and scoped to the specific Sight AI site you connected from.
  3. When you generate a Sight AI article, we publish it via POST https://api.hubapi.com/cms/blogs/2026-03/posts using your default blog, author, tags, and publish state.

​
Setup Instructions

​
Step 1: Open the HubSpot integration page

  1. In Sight AI, go to Integrations.
  2. Make sure the site you want to connect HubSpot to is selected in the sidebar.
  3. Click the HubSpot CMS card.

​
Step 2: Connect HubSpot

  1. Click Connect HubSpot.
  2. You’ll be redirected to HubSpot’s authorization page.
  3. Pick the HubSpot account you want to install Sight AI in.
  4. Review the requested scopes (oauth, content) and click Connect app.
HubSpot will redirect you back to Sight AI and you’ll see the HubSpot portal connected confirmation.

​
Step 3: Pick a default blog

  1. The wizard automatically loads the blogs from your connected portal.
  2. Pick the blog that Sight AI articles should publish to.
If you don’t see any blogs, double-check that your HubSpot plan includes Content Hub or Marketing Hub blog access, then click Retry.

​
Step 4: Pick author + tag defaults (optional)

  1. Default author — every Sight AI post will show this person as the byline. Leave as Use HubSpot default to defer to HubSpot’s per-blog default author.
  2. Default tags — Sight AI will attach these tags to every post for downstream HubSpot reporting.

​
Step 5: Choose draft vs. publish

  • Save as draft (recommended) — Sight AI sends the post to HubSpot as a draft. You can review and publish from inside HubSpot.
  • Publish immediately — Sight AI publishes the post live as soon as it’s synced.
Click Save settings to finalize the connection. HubSpot will now be set as the active CMS for this Sight AI site.

​
What Gets Synced

  • Title — Post name (mapped to HubSpot’s name)
  • Content — Full HTML body
  • Featured Image — Main cover image
  • In-Body Images — Images within the content (alt text auto-applied)
  • Slug — SEO-friendly URL slug
  • Meta description — HubSpot’s metaDescription
  • HTML title — HubSpot’s htmlTitle (uses Sight AI’s SEO title if set)
  • Author — Your configured default blogAuthorId
  • Tags — Your configured default tagIds
  • Publish date — Set to now() when publishing immediately

​
Troubleshooting

​
”HubSpot authentication failed. Please reconnect the integration.”

The OAuth refresh token has been revoked (usually because someone uninstalled the app from inside HubSpot). Reconnect via the integration page.

​
”HubSpot rejected the request (missing scope or insufficient permission).”

Your HubSpot plan doesn’t include the content scope. The blog publishing endpoint requires Content Hub Professional/Enterprise or Marketing Hub Professional/Enterprise. Upgrade in HubSpot or contact your account admin.

​
”No blogs found”

Your HubSpot portal doesn’t have any blogs yet. Create one in HubSpot under Marketing → Website → Blog, then click Retry on the integration page.

​
”HubSpot rate limit exceeded. Please retry in a moment.”

HubSpot’s Public API allows ~100 requests per 10 seconds per portal. Sight AI paces bulk syncs at 15 seconds per article and retries automatically — you should never see this in normal usage. If you do, wait a minute and retry; if it persists, contact support.

​
Posts are stuck in Draft state

This is the default behavior. If you want every Sight AI post to publish immediately, change the Publish state to Publish immediately in the integration settings.

​
Disconnecting

  1. Go to Integrations → HubSpot CMS.
  2. Click Disconnect in the top right.
  3. Confirm. We’ll revoke the refresh token on HubSpot’s side and delete the stored credentials.
Already-published posts in HubSpot stay where they are — disconnecting only stops new syncs.