hubspot

What This Skill Does

The HubSpot skill for OpenClaw provides a direct, high-performance interface for managing your CRM data without the need for third-party proxies. By communicating directly with api.hubapi.com, it allows your agent to perform search, create, update, and association operations on critical CRM entities including contacts, companies, deals, and tickets. This tool is designed for automation workflows where data integrity and direct API interaction are paramount. It supports complex operations such as listing pipeline stages, managing object owners, and executing granular updates on specific records using standard CLI commands executed within the OpenClaw runtime environment.

Installation

1. Install the skill using the command: clawhub install openclaw/skills/skills/codeninja23/native-hubspot
2. Navigate to your HubSpot portal: Settings → Integrations → Private Apps.
3. Create a new private app and assign the necessary scopes: crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.companies.write, crm.objects.deals.read, crm.objects.deals.write, and tickets.
4. Copy your generated Access Token (PAT).
5. Set the required environment variable in your OpenClaw setup: export HUBSPOT_TOKEN=pat-na1-....

Use Cases

This skill is ideal for automating CRM hygiene and sales operations. You can use it to sync lead information from emails directly into HubSpot, update deal stages based on task completion in other tools, or query company data to enrich internal reports. It is particularly useful for sales operations teams looking to minimize context switching by letting the AI handle routine data entry and retrieval tasks directly.

Example Prompts

1. "Search for the contact 'John Doe' in HubSpot and tell me his current company association."
2. "Create a new deal in the default pipeline named 'Enterprise Expansion' with an amount of 50,000 for company ID 67890."
3. "Update the deal stage for deal ID 11111 to 'closedwon' and increase the amount to 75,000."

Tips & Limitations

• Rate Limits: As this calls the HubSpot API directly, ensure your requests adhere to HubSpot’s standard API rate limits to avoid throttling.
• Authentication: Always keep your HUBSPOT_TOKEN secure; do not commit it to version control systems.
• Error Handling: The script returns standard CLI output; verify your object IDs before performing updates or associations to prevent data corruption. If an action fails, check that your Private App scopes cover the requested object type.