hubspot

What This Skill Does

The HubSpot skill for OpenClaw provides a powerful bridge between your AI agent and the HubSpot CRM and CMS platforms. It enables seamless interaction with HubSpot's v3 REST API, allowing the agent to perform complex CRUD (Create, Read, Update, Delete) operations across core objects including contacts, companies, and deals. Whether you need to retrieve customer data for an account review, automate the creation of new sales leads, or query existing pipeline information, this skill provides the necessary endpoints to execute these actions programmatically. By leveraging your existing Private App access token, the agent authenticates securely to manage your business operations directly from the chat interface.

Installation

To integrate this skill into your environment, use the OpenClaw command line interface. First, ensure you have a HubSpot Private App created with the necessary scopes enabled. Install the skill using the following command:

clawhub install openclaw/skills/skills/kwall1/hubspot

Once installed, configure your environment variables to allow the agent to authorize requests:

HUBSPOT_ACCESS_TOKEN=your-private-app-token

Use Cases

This skill is designed for sales, marketing, and customer success teams aiming to reduce manual data entry and expedite information retrieval. Common use cases include: automated lead qualification where the agent searches for existing company data before proceeding; personalized sales outreach by pulling contact details into the conversation flow; and pipeline management, such as updating deal stages or creating new opportunities based on client project progress.

Example Prompts

1. "Check if there are any existing contacts in our CRM with the email address [email protected] and provide their job title and company name."
2. "Search for the company 'Acme Corp' and list the first 5 active deals associated with them in our pipeline."
3. "Create a new contact in HubSpot for Jane Doe with the email [email protected], assigned to the company 'Tech Solutions'."

Tips & Limitations

When using this skill, always ensure your HubSpot Private App scopes are sufficient for the read or write actions you intend to perform. Note that large lists should be queried with appropriate 'limit' parameters to avoid excessive response sizes. The agent relies on precise API property names; if custom fields are missing from your output, ensure your request includes the specific property keys as defined in your HubSpot portal settings. Always handle sensitive customer data according to your organization's privacy policy.