Want a free personalized recommendation for your software stack?Get yours
That Marketing Buddy
Home/API/HubSpot
HubSpot

HubSpot API

Yes. HubSpot publishes a public REST API. See developers.hubspot.com for pricing details.

MCP also availableLLMs: ChatGPT, Claude, Gemini, Perplexity, Copilot
Open API docsTry HubSpot
Public REST API documentedAgent-readiness 8/10
Data from Buddy's database, auto-rechecked weekly

What is the HubSpot API?

HubSpot has a full public API at developers.hubspot.com, and it's one of the most documented in martech. What our extraction didn't pin down: which plan tier unlocks which endpoints, the exact auth method (HubSpot historically uses OAuth and private app tokens), and whether they publish an OpenAPI spec you can feed to an agent.

The practical gap is the plan gating. HubSpot has a habit of putting specific objects, custom properties, and higher rate limits behind Professional or Enterprise. Don't assume Starter gives you everything. Verify on the live pricing page before you commit a build to it.

No official SDKs were surfaced in the data either, though HubSpot does maintain client libraries in several languages. Treat the agent-readiness score of 6 as accurate: the API is there and capable, but the missing OpenAPI spec and unclear gating make autonomous agent setups more work than they should be.

For the broader picture: HubSpot review, full pricing breakdown, .

HOOK IT TO YOUR STACK

Real HubSpot API calls you'll write

hubspot-apirest
#Pull the latest data from HubSpot
GET/v1/records?limit=10&sort=-created_at
200 OK · 10 records
Most recent entry2 min ago
Records this week147
API calls today1,832
Rate limit remaining8,168 / 10k
Schedule via cron, pipe results.
hubspot-apirest
#Push a new record with custom metadata
POST/v1/records
201 Created · record_id: r_5a7
Validationpassed
Webhooks triggered2
Stored size1.2 KB
hubspot-apirest
#Subscribe to webhook events
POST/v1/webhooks
201 Created · webhook_id: wh_3f
Signing secretwhsec_••••
Eventsrecord.created
Statusactive
TMB SCORE FOR HubSpotAgent fit: 8/10
Read review →

Endpoints illustrative. Confirm exact paths against the live API docs before integrating.

What HubSpot exposes

I get HubSpot data through a public REST API (key + OAuth 2.0 auth), a community-built MCP server (not official, watch for breakage), and 2,000-plus integrations including Zapier and Make. The API covers contacts, companies, deals, tickets, products, line items, marketing emails, forms, workflows, custom objects (Enterprise only), and CRM analytics; an OpenAPI spec is published at developers.hubspot.com. Webhooks are available across the platform for event-driven automation. Free and Starter tiers have rate-limited API access; Professional and Enterprise unlock higher quotas, custom objects, and the Operations Hub data sync features. HubSpot has no official llms.txt, /pricing.md, or /llm-info pages, which is unusual for a platform pitching AI agents. The community MCP server fills the gap for agent workflows, but plan for the lack of vendor-curated machine-readable docs.

How much does the HubSpot API actually cost?

Verify on docs

HubSpot publishes an API, but per-tier gating wasn't extracted automatically.

  • Most likely scenario: API access is either included in all paid plans, or it's gated to higher tiers and we need to verify on the live docs page.
  • Until verified, treat the question "which plan unlocks the API" as open. Don't budget on the assumption it's free with the cheapest paid plan.

HubSpot subscription pricing

PlanMonthlyAnnual / mo
FreeFreeFree
Starter$20$7
Professional$890$800
Enterprise—$3,600
HubSpot AEO$50$45

⚠ Per-tier API gating not yet structured for HubSpot. Confirm which plans unlock API access on the live docs.

Source: hubspot.com/pricing/marketing. Verified 2026-06-07.

API at a glance

Auth method
—
SDK languages
—
OpenAPI spec
—
Webhooks
—
Structured outputs
—

HubSpot also has an MCP server

If you're wiring HubSpot into Claude / Cursor / Codex, the MCP server is usually less code than the REST API.

See HubSpot MCP page

What you can build with the HubSpot API

Three personas, three different shapes of build. Pick the row that matches how you actually ship.

SOLO DEV / FOUNDER

Glue HubSpot into your daily workflow

  • Pull a digest of fresh activity into your morning Slack
  • Trigger a one-off backfill when something looks off
  • Pipe data into your own SQLite for ad-hoc queries
Effort: A weekend, one Node or Python script
AGENCY / CONSULTANT

Sell HubSpot reporting at scale

  • White-label HubSpot data into client-branded dashboards
  • Run scheduled multi-account reports without logging into the HubSpot UI
  • Cross-reference with the rest of the client's stack (CRM, analytics, ad spend)
Effort: 1-2 weeks, hits multi-tenant auth quickly
IN-HOUSE ENGINEER

Production pipelines for HubSpot

  • Real-time sync into your warehouse on a cron
  • Custom alerts the dashboard's built-in alerting can't express
  • Backfill + idempotency handling for HubSpot data older than the dashboard exposes
Effort: Multi-week project, expect rate-limit tuning

Quickstart template

# Starter template — endpoint paths and SDK package names come from
# the HubSpot API docs: https://developers.hubspot.com

curl -X GET "https://developers.hubspot.com/<your-endpoint>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json" | jq .

Template only. Endpoint paths, exact base URL, and auth header format come from developers.hubspot.com.

Limits and gotchas

  • No OpenAPI spec — you write typed clients by hand or use a third-party generator on the docs HTML.
  • No official SDK detected. Plan on hitting the API directly with your HTTP client of choice.
  • Rate limits: always read the docs page before scaling — the published limit is usually lower than the practical one and overages can be expensive.
  • No-code fallback: Zapier and Make.com cover the common triggers if you want to skip writing API code for simple flows.
8/10

Agent-readiness verdict

Solid API for automation if you're already paying for HubSpot and willing to read the docs carefully. For pure agent-driven workflows, the lack of a confirmed OpenAPI spec and the plan-gating fog mean you'll spend more time scoping than building. Budget for both.

Strong agent fit with an official, HubSpot-hosted MCP server. The remote CRM MCP server at mcp.hubspot.com is generally available, connects any MCP client over streamable HTTP, and authenticates with OAuth 2.1 (PKCE), with read and write access across contacts, companies, deals, tickets, and more. An official npm package and a large documented API round it out. Agents get a first-party, well-supported integration path here.

MCP server availablePublic API with docsNative Claude integrationNative ChatGPT integration

HubSpot API FAQ

Does HubSpot have a public API?+
Yes — REST API at developers.hubspot.com.
Should I use the API or the MCP server for Claude / Cursor / Codex?+
Prefer the MCP server for agent workflows — it's less code and pre-handles auth flows. Use the REST API for scheduled jobs, dashboards, and anything outside an LLM-driven flow.

Sources

Joonas Rotko
Joonas RotkoAuthor & Founder of That Marketing Buddy

10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.

About meHow I review

HubSpot

Try HubSpot
WEEKLY NEWSLETTER

The marketing tools worth your money, scored for AI agent readiness

Every week I score the tools for MCP, API, and agent-readiness, then email you the ones that actually deliver, what plugs into Claude and Cursor, the pricing changes, and what to skip. No fluff, no daily spam.

Join for free. One email a week, unsubscribe anytime.