1. Home
  2. Systems
  3. HubSpot integration

HubSpot's API: up to 190 calls per 10 seconds, and a September 2027 deadline

You can connect HubSpot to your other software through its API or through one of HubSpot's own apps. Private apps get 100 requests every 10 seconds on Free and Starter, and 190 on Professional and Enterprise. HubSpot ends support for its v1 to v3 APIs in September 2027, so a link built on them has to move to the new dated versions.

Checked 18 November 2026

HubSpot’s API limits depend on your edition

Your edition sets the ceiling. HubSpot’s usage guidelines give privately distributed apps these limits:

Scroll the table sideways to see every column.

Edition Limit per app Limit per account each day
Free and Starter 100 requests per 10 seconds 250,000
Professional 190 requests per 10 seconds 625,000
Enterprise 190 requests per 10 seconds 1,000,000
With the API limit increase 250 requests per 10 seconds 1,000,000 more, up to two increases

The daily limit is shared by every app in the account. The 10-second limit counts per app. An OAuth app listed in HubSpot’s marketplace gets 110 requests every 10 seconds in each account that installs it, not counting CRM Search.

Search is stricter than any row in that table. The CRM Search API allows five requests a second per account. That is half the 100-per-10-seconds limit on Free and Starter, and about a quarter of the 190 on Professional and Enterprise. So a link that looks records up one at a time hits the search limit first. One search page holds up to 200 records. A query stops at 10,000 results. It can be at most 3,000 characters long. Search replies don’t carry the rate limit headers. Your code has to count.

Go over a limit and HubSpot replies with a 429 error. HubSpot asks that errors stay under 5 percent of your daily requests. The daily count resets at midnight, in the time zone your account is set to.

Every HubSpot API version now has an end date

HubSpot moved to dated versions in 2026. Since March 30th 2026, REST API paths carry a date, such as /2026-03/. A new version ships every 6 months, in March and September. Each one stops being supported 18 months after it becomes generally available. HubSpot’s versioning page says an unsupported version may still work, but you should not expect it to stay stable.

On 15 September 2026, HubSpot set the end for its older APIs and apps:

  • v1 to v3 APIs. Unsupported from September 2027. HubSpot says they then get no bug fixes, reliability work or security updates. The old paths still answer at their old addresses for now.
  • v4 APIs. Support ends sooner, on March 30, 2027.
  • Legacy public apps. Apps made before June 23, 2026 use HubSpot’s older app design. They became unsupported on September 15, 2026. From September 2027, a marketplace app still on that design can be delisted.
  • Projects 2025.2 and older. Apps on these versions must move to the current version, 2026.09, by March 2027. HubSpot gives 2026.09 an 18-month support window.
  • Legacy private apps. New ones stopped on September 28, 2026 in new accounts and on October 26, 2026 in existing ones. Old ones lose support in September 2027.
  • Marketplace apps. An app that still calls v1 to v4 after September 2027 loses its certification.

HubSpot says to move straight to the dated versions, not to v3 or v4 on the way. Its check for old APIs watches the calls your app makes, not your code. Two older APIs are already gone. HubSpot sunset the Ecommerce bridge and the Accounting extension on February 28, 2023.

A service key for one account, OAuth for many

Use a service key when a link serves only your own HubSpot account. Use OAuth for many. HubSpot’s guide says OAuth is required for apps installed in several accounts. A privately distributed OAuth app can sit in at most 10 accounts at a time.

HubSpot now points new private links to service keys instead of legacy private apps. Its Fall 2026 Spotlight lists service keys as a public beta, so check the guide before you build on one. These facts shape the design:

  • A service key calls REST APIs with scopes for each object, such as contacts or deals.
  • It can’t sign webhooks or UI extensions.
  • It can rotate on its own every 3, 6 or 12 months. If you rotate a key by hand and choose Rotate and expire later, the old key expires in 7 days.
  • Service keys share one cap with project apps and MCP connectors: 100 in total per account.

With OAuth, an access token carries the scopes the app asked for, not the user’s rights inside HubSpot. A user-level app on platform 2026.09 is the exception. HubSpot says it enforces that user’s exact HubSpot permissions at runtime. HubSpot also warns that a 401 error is not a reliable sign that a token has expired. Read the expires_in value and refresh before it runs out.

Webhook rules differ for legacy and current apps

A webhook saves your link from asking HubSpot over and over. On HubSpot’s current app platform, HubSpot sends a POST to your endpoint when a subscribed event happens, and your app returns a 2xx status code to acknowledge it. You set your own concurrency limit there, in maxConcurrentRequests: the most HTTP requests HubSpot will make in a given time frame. That guide does not restate a timeout or a retry rule, so test both on your own app.

HubSpot’s webhooks guide for legacy public apps sets these rules:

  • A reply slower than five seconds counts as a timeout.
  • HubSpot retries a failed notice up to 10 times over the next 24 hours.
  • Notices can arrive out of order and more than once, so sort them by occurredAt and skip repeats.
  • Each request carries an X-HubSpot-Signature header, a SHA-256 hash made with your app secret. Check it before you trust the data.
  • HubSpot sends at most 10 requests at once to each installing account, with up to 100 events in each.
  • Webhook calls that HubSpot makes to your service do not count against your app’s API limits.

HubSpot’s usage guidelines add one cap for every app: up to 1,000 webhook subscriptions.

Admin rules now bind API writes on /2026-09/

Calls on the /2026-09/ version, shipped September 8, 2026, must follow the record rules an admin sets. Before, those rules bound only people working in HubSpot’s screens. Say an admin makes a field required once a deal is won. An API write on /2026-09/ that leaves it out now gets a 400 error.

HubSpot corrected its post on October 27, 2026. Required associations still apply in the app only, not to API writes. Before you move a link to /2026-09/, test it against the rules in each account it writes to.

HubSpot’s own apps sync NetSuite, QuickBooks and Xero

Check HubSpot’s own app before you build. Three reach ERP or accounting systems:

Scroll the table sideways to see every column.

HubSpot app What it syncs A limit to know
NetSuite Contacts, companies, deals, invoices and sales orders Custom field maps need a Data Hub subscription
QuickBooks Online Contacts (two-way by default), products matched on SKU, invoices, and payments made after you connect Does not yet support accounts outside the US
Xero (data sync) Contacts, products, invoices and payments Six currencies only: USD, CAD, EUR, GBP, AUD and NZD

For any other ERP, the link runs on HubSpot’s API or a custom build.

Six HubSpot pages each settle one question

Each page below takes one job or one pairing:

  • MCP server: what HubSpot’s MCP server at mcp.hubspot.com lets an AI agent read and write, and how it signs in.
  • Workflows and automation: what workflows can do inside HubSpot, and which actions, such as custom code, need Data Hub.
  • Shopify: HubSpot’s Shopify sync updates records within 10 minutes of a change, and syncs companies only on Shopify Plus.
  • Slack: the Slack app links one workspace only, and Breeze Assistant in Slack can sum up records and threads.
  • Outlook: you can sync Outlook Calendar or Google Calendar but not both, and Outlook contacts sync one way or both ways.
  • Xero: the Xero sync handles six currencies, and invoices on HubSpot’s automated sales tax don’t sync.

Three more pairing pages are live: HubSpot and QuickBooks, HubSpot and NetSuite and Salesforce and HubSpot.

Build on a developer test account first

HubSpot’s developer test accounts are free, each one comes with 90 days of many Enterprise features, and a standard account can make up to 10 of them, so you can build a link on sample data before it touches a live record. Keep it busy. A test account expires after 90 days with no API calls.

HubSpot hosts in AWS US East, with an EU option in Frankfurt

HubSpot runs its product on Amazon Web Services, in the US East region. New customers since July 19, 2021 can keep their data in an EU data center in Frankfurt, Germany. Existing customers can move their data there with HubSpot’s data migration tool. Your link moves data in and out of that region, so put the hosting choice in your data review.

Our team has set up HubSpot end to end, built HubSpot to ERP integrations and built HubSpot agents on Anthropic’s Claude. For the AI side of HubSpot, see HubSpot AI agents. For how we connect systems in general, see AI integration services.

Questions

What is CRM API integration?

It is a link between your CRM and another system, built on the CRM's API. An API is a set of web addresses that a program calls to read or change records. In HubSpot, that could mean reading deals or creating a company. HubSpot's own apps cover a few pairs, such as NetSuite and Xero. Any other link is coded against HubSpot's API and has to stay inside its limits.

Can we use HubSpot's API on the Free plan?

Yes. HubSpot's usage guidelines give privately distributed apps on Free and Starter 100 requests every 10 seconds, and 250,000 a day for the account. Professional raises that to 190 requests and 625,000 a day. Enterprise gets 190 requests and 1,000,000 a day. Every app in the account shares the daily number, so two busy links can starve each other.

When does HubSpot stop supporting its v3 APIs?

In September 2027, HubSpot says. From then its v1 to v3 APIs get no bug fixes, reliability work or security updates. Support for v4 ends sooner, on March 30, 2027. HubSpot's versioning page says unsupported versions may still work, but you should not expect them to stay stable. So move straight to the dated versions, not to v3 or v4 on the way.

Should we use a service key or a private app?

Use a service key for a new link to one account. HubSpot's Fall 2026 Spotlight lists service keys as a public beta, the replacement for legacy private apps. New legacy private apps stopped on September 28, 2026 for new accounts and on October 26, 2026 for existing ones. A service key only makes REST calls and can't sign webhooks, so a link that listens for changes still needs an app.

Does HubSpot integrate with our ERP?

HubSpot has its own apps for NetSuite, QuickBooks Online and Xero, and the table on this page shows what each one syncs. Each has a limit worth checking first. The QuickBooks Online app, for one, does not yet support accounts outside the US. For any other ERP, the link is built on HubSpot's API, within the limits above.

Do we need an official HubSpot partner to do this?

Not for an integration. What matters is a team that knows HubSpot well and builds on the APIs HubSpot publishes. Our team has set up HubSpot end to end, built HubSpot to ERP integrations and built HubSpot agents on Anthropic's Claude. You license HubSpot from HubSpot or its reseller. We handle the consulting, setup, data move and build from there.

Sources

Every source behind a figure or a vendor fact on this page, with the day we read it.

Pages in this section

  • HubSpot and OutlookHubSpot works with Outlook through its Office 365 add-in, inbox link, calendar sync and Outlook Contacts. Its desktop add-in is in maintenance mode.
  • HubSpot and ShopifyHubSpot's own Shopify app syncs customers, companies, products, orders, carts and discount codes. Match rules, Shopify Plus limits and gaps, checked.
  • HubSpot and SlackHubSpot's Slack app posts alerts, creates tasks and tickets from messages and runs Breeze Assistant in Slack. Plan rules and Slack's API limits, checked.
  • HubSpot and XeroHubSpot's own Xero app syncs contacts, products, invoices and payments, one way or both. Six currencies, tax rules and invoice limits, checked.
  • HubSpot automationHubSpot's full workflow builder needs Professional or Enterprise, and Starter gets simple automation. Triggers, actions, code limits and sequences.
  • HubSpot MCPHubSpot runs an official MCP server at mcp.hubspot.com. What its tools read and write, how it signs in with OAuth and PKCE, and what is still in beta.

Plan your HubSpot integration

Bring your HubSpot editions, the systems HubSpot should talk to and roughly how many records change each day. The first call is free.

Plan my HubSpot integration