Hubspot Pack

> Claude Code skill pack for HubSpot CRM integration -- 10 production-engineer skills built from a real-world pain catalog, covering auth, webhooks, dedup, migrations, pipeline automation, and rate-limit survival on the CRM v3 API.

What is HubSpot?

HubSpot is a CRM platform for marketing, sales, and customer service. The HubSpot API (v3) provides programmatic access to CRM objects (contacts, companies, deals, tickets), marketing tools (emails, forms, lists), and automation (webhooks, workflows). The official Node.js SDK is @hubspot/api-client.

Pack Overview

Version 2.0.0 is a deliberate rebuild: the original 30 template skills were replaced by 10 deeper, pain-catalog-grounded skills written for production engineers. Each skill targets the failure modes that actually burn HubSpot integrations — wrong-winner merges, webhook replay storms, portal quota exhaustion, cross-portal contamination — using real HubSpot API endpoints (/crm/v3/objects/*), the actual @hubspot/api-client SDK, and documented error responses.

Installation

/plugin install hubspot-pack@claude-code-plugins-plus

Quick Start

npm install @hubspot/api-client
export HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

import * as hubspot from '@hubspot/api-client';

const client = new hubspot.Client({
  accessToken: process.env.HUBSPOT_ACCESS_TOKEN!,
  numberOfApiCallRetries: 3,
});

// Create a contact
const contact = await client.crm.contacts.basicApi.create({
  properties: { email: '[email protected]', firstname: 'Jane', lifecyclestage: 'lead' },
  associations: [],
});

// Search contacts
const results = await client.crm.contacts.searchApi.doSearch({
  filterGroups: [{
    filters: [{ propertyName: 'lifecyclestage', operator: 'EQ', value: 'customer' }],
  }],
…

Skills Included

Key HubSpot API Concepts

• Base URL: https://api.hubapi.com
• Auth: Private app access tokens (pat-na1-*) or OAuth 2.0
• Rate limits: 10 requests/second, 500,000/day (shared per portal)
• Batch limit: 100 records per batch operation
• Search limit: 10,000 results maximum (use getPage for full exports)
• SDK package: @hubspot/api-client (not @hubspot/sdk)

Usage

Skills trigger automatically when you discuss HubSpot topics:

• "Set up HubSpot auth for production" triggers hubspot-auth
• "Our webhook handler is double-processing events" triggers hubspot-webhook-handlers
• "I'm getting 429s from HubSpot" triggers hubspot-rate-limit-survival
• "We have thousands of duplicate contacts" triggers hubspot-contact-dedup

License

MIT