hubspot-crm-expert

Integrate HubSpot CRM APIs with rate limiting and batch operations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/WalkerVVV/firstmile-deals-pipeline --skill hubspot-crm-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-crm-expert
Source: https://github.com/WalkerVVV/firstmile-deals-pipeline/tree/main/.claude/skills/hubspot-crm-expert
Command: npx skills add https://github.com/WalkerVVV/firstmile-deals-pipeline --skill hubspot-crm-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Production-tested HubSpot CRM API patterns for rate limiting, associations, timestamps, and batch operations. Use this skill to automate robust HubSpot integrations while avoiding common pitfalls and errors.

Core Features & Use Cases

  • Rate limiting and exponential backoff patterns to prevent 429s and API throttling.
  • Inline association rules with HUBSPOT_DEFINED types and primary associations for Lead creation.
  • Timestamp handling using Unix milliseconds as strings for all date fields.
  • Batch operations for bulk create/update with 100-record limits.
  • Reference-driven guidance for common HubSpot endpoints and payload structures.

Quick Start

Use this skill to plan HubSpot actions: first check duplicates with /check-lead, then create or update with /add-lead, ensuring 578/580 PRIMARY associations inline.

Frequently Asked Questions about hubspot-crm-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle HubSpot API rate limiting without getting 429 errors?

Rate limiting in HubSpot requires exponential backoff on 429 responses. This skill implements backoff patterns to automatically retry throttled requests, preventing API errors and maintaining integration stability during high-volume operations.

What's the correct way to create leads and contacts in HubSpot with associations?

Lead creation requires inline PRIMARY associations using HUBSPOT_DEFINED types in the initial payload. This skill handles association rules so leads and contacts are created with proper relationships in a single operation, avoiding failed secondary calls.

How do I bulk create or update records in HubSpot without hitting API limits?

HubSpot batch endpoints accept a maximum of 100 records per request. This skill structures bulk operations within batch limits and applies rate limiting, enabling safe high-volume lead, contact, and deal creation.

Why does my HubSpot timestamp data look wrong, and how do I fix it?

HubSpot date fields require Unix milliseconds encoded as strings, not standard timestamps. This skill handles timestamp conversion so date fields populate correctly across leads, contacts, and deal stage transitions.

Can I use HubSpot API integrations without hardcoding API keys in my code?

Hardcoded API keys pose security risks. This skill demonstrates environment-driven credential management, keeping keys external from your integration code while maintaining safe authentication to HubSpot endpoints.

Does HubSpot handle owner ID and pipeline ID filtering for segmented operations?

HubSpot supports owner and pipeline filtering to segment leads, contacts, and deals by ownership and workflow. This skill applies these filters during creation and association to enforce organizational routing and data governance.