The CloudRadial AutomationAI HubSpot CRM extension lets a workflow or agent look up and manage records in HubSpot CRM: contacts, companies, deals, tickets, notes, and tasks. This article covers what the extension can do, the private app and secrets it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating a HubSpot Private App
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Skills
- Tips for Working With HubSpot Data
What the Extension Covers
The extension calls the HubSpot CRM v3 API and provides 19 tools across these areas:
| Area | What you can automate |
| Contacts | Read a contact by id, search contacts by email, name, or another property, and create or update a contact |
| Companies | Read a company by id and search companies by name or domain. Read-only. |
| Deals | Read and search deals, create a deal, and update one, for example to move its stage or change its amount |
| Tickets | Read and search support tickets, create a ticket, and update one, for example to change its stage or priority |
| Notes | Log a timestamped note against a contact, company, deal, or ticket |
| Tasks | Create a task (a to-do, call, or email reminder), optionally tied to a record, read and search tasks by status, owner, or due date, and update a task, for example to mark it completed |
The extension connects to one HubSpot account for your workspace. Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating a HubSpot Private App
The extension signs in with the access token of a HubSpot private app.
- In HubSpot, go to Settings > Integrations > Private Apps and select Create a private app.
- On the Scopes tab, grant the CRM scopes your automations need. The full set the extension uses is
crm.objects.contacts.readand.write,crm.objects.companies.readand.write,crm.objects.deals.readand.write,tickets, andcrm.objects.tasks.readand.write. For read-only use, grant only the.readscopes. - Copy the generated access token. It starts with
pat-.
Treat the token like a password: it carries every scope you granted.
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
HubSpot-BaseUrl |
https://api.hubapi.com. HubSpot's EU and other data centers use the same host. |
HubSpot-PrivateAppToken |
The private app access token |
For how to add these, see Accessing and updating your runner's Key Vault. The agent reads the credentials from the runner and never asks you for them.
Reads and Approval-Gated Changes
Of the 19 tools, 10 are read-only and run without interruption. The other 9 create or change something, and every one of them is approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Create or update a contact; create or update a deal; create or update a ticket; create a note; create or update a task |
| Read-only | Get and search contacts, companies, deals, tickets, and tasks |
The extension has no delete or archive tools.
Skills
The extension ships seven skills that guide an agent through common HubSpot tasks:
| Skill | Use it to |
| Find a contact | Look up a contact by id, or search by email, name, or another property. Read-only. |
| Create or update a contact | Create a contact or update properties on an existing one. Approval-gated. |
| Find a company | Look up a company by id, or search by name or domain. Read-only. |
| Look up or manage deals | Find deals, check pipeline stage and amount, or create or update a deal. Creates and updates are approval-gated. |
| Look up or manage tickets | Find support tickets, check status, or create or update a ticket. Creates and updates are approval-gated. |
| Log a note on a record | Add a timestamped note to a contact, company, deal, or ticket. Approval-gated. |
| Create or manage tasks | Create a task, optionally tied to a record, or look up or update existing tasks. Creates and updates are approval-gated. |
Tips for Working With HubSpot Data
- HubSpot returns only a small default set of properties unless a read asks for specific ones. Name the properties you want, such as email, phone, or lifecycle stage, and the agent requests them.
- Search results can lag a new or updated record by a few seconds. To check a record right after creating it, read it by id rather than searching for it.
- A task's timestamp is its due date, not the date it was created
- To complete a task, update its status to Completed
- HubSpot ids are strings, so pass them exactly as HubSpot returns them
- If HubSpot returns a 429 error, the account hit its rate limit. Wait and try again.
- If an approved create or update fails, check that the private app has the matching
.writescope
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.