HubSpot is retiring v1–v4 APIs — is our stack ready for March 2027?

Every private app, integration, and script calling /crm/v3/ or older has a deadline: March 30, 2027. This skill inventories your portal’s API surface — private apps, connected apps, webhooks — and flags everything on legacy versions with a migration checklist to the date-based releases.

The deadline fails quietly: unsupported APIs "no longer receive updates, bug fixes, or stability guarantees," and marketplace apps that don't migrate risk losing certification. A portal typically has more callers than anyone remembers — private apps, marketplace apps, middleware (Zapier/Make), form embeds, internal scripts, data warehouse syncs. Finding them takes an afternoon now or an incident later. — from the Audit API Usage Before the 2027 Version Cutoff skill

Fix it with one command

The audit-api-usage skill walks Claude Code through the entire fix — audit, CSV baseline, execution, and verification.

/plugin marketplace add tomgranot/hubspot-admin-skills
/plugin install hubspot-admin@hubspot-admin-skills
/audit-api-usage

See the full audit-api-usage skill

Frequently asked questions

What replaced HubSpot’s v3 and v4 API versions?

Date-based versions (like 2026-03) released twice a year with an 18-month support window. Legacy v1–v4 endpoints remain supported until March 30, 2027.

More audit & planning skills

/connect-hubspot-mcp

Connect Claude Code to HubSpot's official remote MCP server for natural-language CRM reads and writes. Covers OAuth setup, scope selection, verification, and when to use MCP versus this repo's API scripts.

/hubspot-audit

Run a comprehensive HubSpot CRM database audit. Analyzes contacts, companies, deals, engagement, data quality, and deliverability. Use when starting a CRM cleanup, onboarding a new client, or performing quarterly health checks.

scripted

/hubspot-implementation-plan

Generate a phased implementation plan from a HubSpot audit report. Creates prioritized, sequenced cleanup processes with effort estimates, dependencies, and automation feasibility. Use after running /hubspot-audit.