CRM
HubSpot API and integration guide
HubSpot's REST APIs cover contacts, companies, deals and custom objects, with OAuth or static tokens, free developer test accounts, webhooks, and published per-app and per-account limits.
Last verified October 2026 against the sources below. Confirm details with HubSpot before you build.
At a glance
- Category
- CRM · HubSpot
- API style
- REST/JSON, with date-versioned APIs.
- Authentication
- OAuth 2.0 authorization code for apps installed in many accounts; static access tokens for single-account (private) apps. Legacy private app tokens don't expire and can be rotated.
- Sandbox / developer program
- Yes. Free developer test accounts (up to 10) with a 90-day trial of many enterprise features; standard and development sandboxes require Enterprise.
- Webhooks / events
- Yes. Subscriptions for creation, property change and association events on contacts, companies, deals, tickets and more, signed with X-HubSpot-Signature and retried up to 10 times over 24 hours.
- Rate limits
- Private apps: 100 requests per 10 seconds on Free and Starter (250,000 per day per account), 190 per 10 seconds on Professional (625,000 per day) and Enterprise (1,000,000 per day). Marketplace OAuth apps: 110 per 10 seconds per installing account.
- Exports and files
- Not confirmed. Confirm with vendor.
- Marketplace / partner program
- HubSpot App Marketplace (listing and certification requirements apply).
Key objects for construction workflows
- Deals and pipeline stages
- Companies
- Contacts
- Line items
- Products
- Tickets
- Custom objects
- Associations
Notes and gotchas
- The daily limit is shared by every app in the account; the burst limit is per app.
- Webhook responses slower than five seconds count as timeouts and are retried, so acknowledge fast and process later.
- Pick one won stage in one pipeline as the trigger for project setup, and write it down.
Sources
Frequently asked questions
What are HubSpot's API rate limits?
For private apps, 100 requests per 10 seconds on Free and Starter and 190 on Professional and Enterprise, with daily limits of 250,000 to 1,000,000 per account. Marketplace OAuth apps get 110 per 10 seconds per installing account.
Can HubSpot trigger a Procore project when a deal closes?
Yes. A webhook subscription or workflow on the deal stage can start a flow that creates the Procore project and stamps the HubSpot deal ID on it, so both systems share a key from day one.
Is there a free HubSpot developer account?
Yes. Developer test accounts are free, you can create up to 10, and they include a 90-day trial of many enterprise features.
Next step
Connecting HubSpot to your other systems?
Bring the systems and the report or workflow you want to fix. We'll walk through what moves, who owns each record, and what to check first.