Skill

hubspot-agent-standards

Mandatory standards for all HubSpot agents. Use when performing ANY HubSpot API operation, bulk data operation, workflow automation, or contact/deal management. Provides batch operation patterns, rate limit handling, pagination, error handling, and safety protocols.

From opspal-hubspot

Install

Run in your terminal

npx claudepluginhub revpalsfdc/opspal-commercial --plugin opspal-hubspot

Tool Access

This skill is limited to using the following tools:

ReadGrepGlob

Supporting Assets

View in Repository

api-patterns.md

data-validation.md

error-handling.md

rate-limits.md

Skill Content

Similar Skills

skill-lookup

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

157.6k

prompt-lookup

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

157.6k

executing-plans

Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.

superpowers

137.7k

Stats

Parent Repo Stars0

Parent Repo Forks1

Last CommitMar 18, 2026

Actions

View Source View Plugin View on GitHub View README

Quick Reference

Decision Tree for Data Operations

Record Count

Method

Library

<10 records

Single/batch API

Either acceptable

10-10k records

Batch endpoints (100/call)

batch-update-wrapper.js

>10k records

Imports API (async)

imports-api-wrapper.js

Mandatory Library Usage

Scenario

Required Library

Update >10 records

batch-update-wrapper.js

Create/update uncertainty

batch-upsert-helper.js

Any associations

batch-associations-v4.js

Import >10k records

imports-api-wrapper.js

Property metadata

batch-property-metadata.js

Performance Benchmarks

Operation

Record Count

Expected Duration

Batch Create

1000

<3 seconds

Batch Update

1000

<3 seconds

Batch Delete

1000

<5 seconds

Import (Async)

50,000

<10 minutes

Core Principles

1. Always Use HubSpotClientV3

Automatic rate limit handling (100 req/10s)

Exponential backoff on 429 errors

Complete pagination support

Retry logic for transient failures

2. Complete Pagination (MANDATORY)

ALWAYS check paging.next.after

ALWAYS use page_size: 100 (maximum)

Search API has 10k limit - use Exports API for larger datasets

3. No-Mocks Policy

ZERO synthetic data generation

All data from real HubSpot API

Fail explicitly when queries cannot execute

4. Delete Safety Protocol (5 Steps)

Backup records

Validate associations transferred

Require explicit confirmation

Execute deletion

Write audit log

HubSpot Agent Standards

When to Use This Skill

Performing any HubSpot API operation
Executing bulk data operations (>10 records)
Creating or modifying workflows
Working with contacts, companies, deals, or tickets
Implementing HubSpot integrations
Handling large dataset imports/exports

Quick Reference

Decision Tree for Data Operations

Record Count	Method	Library
<10 records	Single/batch API	Either acceptable
10-10k records	Batch endpoints (100/call)	`batch-update-wrapper.js`
>10k records	Imports API (async)	`imports-api-wrapper.js`

Mandatory Library Usage

Scenario	Required Library
Update >10 records	`batch-update-wrapper.js`
Create/update uncertainty	`batch-upsert-helper.js`
Any associations	`batch-associations-v4.js`
Import >10k records	`imports-api-wrapper.js`
Property metadata	`batch-property-metadata.js`

Performance Benchmarks

Operation	Record Count	Expected Duration
Batch Create	1000	<3 seconds
Batch Update	1000	<3 seconds
Batch Delete	1000	<5 seconds
Import (Async)	50,000	<10 minutes

Core Principles

1. Always Use HubSpotClientV3

Automatic rate limit handling (100 req/10s)
Exponential backoff on 429 errors
Complete pagination support
Retry logic for transient failures

2. Complete Pagination (MANDATORY)

ALWAYS check paging.next.after
ALWAYS use page_size: 100 (maximum)
Search API has 10k limit - use Exports API for larger datasets

3. No-Mocks Policy

ZERO synthetic data generation
All data from real HubSpot API
Fail explicitly when queries cannot execute

4. Delete Safety Protocol (5 Steps)

Backup records
Validate associations transferred
Require explicit confirmation
Execute deletion
Write audit log

Detailed Documentation

See supporting files:

api-patterns.md - HubSpot API conventions
rate-limits.md - Rate limit handling
error-handling.md - Error recovery patterns
data-validation.md - Property validation rules