hubspot-by-altf1be

What This Skill Does

The HubSpot by @altf1be skill provides a comprehensive CLI-based interface for managing the entire HubSpot platform directly from your terminal. It acts as a powerful bridge between OpenClaw and your HubSpot instance, enabling CRUD (Create, Read, Update, Delete) operations across CRM objects, CMS content, marketing assets, and automation workflows. Whether you are managing sales pipelines, syncing contact information, or auditing automated workflows, this tool provides a robust, programmatic way to interact with HubSpot without needing to open the web dashboard for repetitive tasks.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/abdelkrim/hubspot-by-altf1be. Once installed, navigate to the base directory and execute npm install to set up dependencies. You must configure authentication by creating a Private App within HubSpot and setting your HUBSPOT_ACCESS_TOKEN as an environment variable, or by configuring OAuth 2.0 credentials if your security policy requires it. Ensure the specific scopes (contacts, companies, deals, etc.) are enabled in your HubSpot app settings to allow the CLI to interact with the corresponding modules.

Use Cases

This skill is perfect for developers, sales ops, and marketing automation specialists. Use it to automate bulk contact updates, programmatically export company records for local data analysis, or check the status of active marketing campaigns. It is particularly effective for "headless" CRM management, where you need to integrate HubSpot status into other automated workflows or CI/CD pipelines.

Example Prompts

1. "HubSpot, please search for a contact with the email [email protected] and tell me their current phone number and status."
2. "Can you create a new company record in HubSpot named 'Acme Corp' with the domain acme.com and link it to our current sales pipeline?"
3. "List all current deals in the CRM and identify which ones have been inactive for more than 30 days."

Tips & Limitations

Always use the --confirm flag carefully when running delete commands, as this action cannot be undone through the CLI. Keep your environment variables secure—never commit .env files containing your access tokens to source control. Note that this skill relies on the HubSpot API limits; if you process very large datasets, ensure you monitor your request rate to avoid 429 Too Many Requests errors. Always verify your Private App scopes if you receive '403 Forbidden' errors, as HubSpot requires explicit scope permissions for every endpoint accessed.