Step 1 — Connect in Ryze
On the Integrations page, find the HubSpot card and click Connect. You’re redirected to HubSpot to authorize.You can also start from the Ryze listing in the HubSpot Marketplace. HubSpot sends you to Ryze — sign in if asked, and Ryze starts the usual HubSpot authorization for the workspace that opens by default when you sign in. If the install doesn’t finish, you land back in Ryze — connect from the Integrations page instead.
Step 2 — Authorize in HubSpot
1
Sign in to HubSpot
Sign in to the HubSpot account you want to connect, or create a new one.

2
Choose the account
If you have access to more than one HubSpot account (portal), pick the one you want Ryze to work with, then click Choose Account.
3
Approve access
Review the requested permissions and approve. HubSpot sends you back to Ryze and the connection is saved.
Step 3 — Confirm the connection
Back in Ryze, the HubSpot card shows a Connected badge. Click View on the card to see the account you linked — identified by its HubSpot domain (likeyourcompany.com).

Connect multiple accounts
You can connect more than one HubSpot account (portal) in the same workspace. Click View on the HubSpot card, then Add one more account, and repeat the authorization. See Connect multiple accounts for how the agent picks between them.What the agent can do
Once connected, the agent works with HubSpot through your account:- CRM records — read and edit contacts, companies, and deals
- Search — filter and query records with the HubSpot CRM Search API
- Lists — read your contact lists
- Owners — look up account owners to attribute records
- CMS — read and edit blog content
- Delete — delete records or blog posts when you explicitly ask. Most CRM deletes move the record to HubSpot’s recycling bin; deleted blog posts may not be recoverable.
Publishing articles to HubSpot
HubSpot is also a publishing destination: programmatic articles can land on your HubSpot blog instead of (or as well as) a separate CMS.- Click View on the HubSpot card, pick the Blog and the Author the posts should use, and click Save — both are stored choices, so every article publishes consistently. Reconnecting the same HubSpot account keeps them.
- Ryze publishes using HubSpot’s own slug and publish rules, and only marks an article as published once HubSpot confirms the post is actually live.
- If an image can’t be uploaded to HubSpot, the article still publishes and the skipped image shows as a warning on the article, so you can fix it rather than lose the post.
The Blog and Author choices are only needed if you publish articles to HubSpot — if you use HubSpot for CRM only, leave them empty. If the lists are empty, create a blog in HubSpot (Content → Blog) and an author (Content → Blog → Authors), then click View on the HubSpot card and pick them — no need to reconnect.
Troubleshooting
- Wrong account connected — each connection is one HubSpot portal. To switch, click View on the HubSpot card and connect the right portal with Add one more account, and remove the wrong one with Disconnect (the trash icon) in the same window.
- Connection stopped working — click Reconnect on the HubSpot card and re-authorize. This refreshes access if permissions changed or the token was revoked in HubSpot.
- Missing records or fields — HubSpot returns a default set of properties; ask the agent for the specific fields you need. If a whole object type is missing, the connected user may not have access to it in HubSpot.

