How to Get Your HubSpot API Key (and What to Build With It)
How HubSpot API access works, what the HubSpot API lets you connect, and when you need a developer to do it properly. Perth, Melbourne, Sydney and Brisbane.
How HubSpot API access works, what the HubSpot API lets you connect, and when you need a developer to do it properly. Perth, Melbourne, Sydney and Brisbane.
Who this is for
Sales and marketing managers, operations managers who want to connect HubSpot to other systems and need to understand how its API works before committing to anything.
Question this answers
How do I get HubSpot API access and what can I actually connect HubSpot to?
What you will leave with
HubSpot uses a private app access token created inside your HubSpot account. The exact screens move around as HubSpot updates its interface, so rather than repeat a menu path that may already be out of date, the reliable source is the official documentation: HubSpot developer documentation.
HubSpot retired its old API keys in late 2022. Private app tokens replaced them and are scoped, so a token only reaches the objects you allow. Anything acting for other HubSpot accounts uses OAuth instead.
Treat API credentials like a password. Anyone holding them can read and often write data in your HubSpot account. Do not paste them into untrusted tools, and do not send them over email or chat.
The HubSpot API gives you programmatic access to the core data in your account. Broadly that covers:
With that access you can push data into accounting or reporting systems, keep records in step across tools, and build dashboards from live HubSpot data rather than from exports someone has to remember to run.
HubSpot has a native Zapier connector. For simple one-way automation, a Zap is often the right answer and costs a fraction of a build. HubSpot has a strong Zapier connector, which handles most simple field-to-field automation.
Connecting HubSpot to another system means working through five things, in roughly this order:
A common pairing is HubSpot with Xero or MYOB. Read-only reporting is usually straightforward. Live two-way sync is where the mapping and error handling turn it into a proper development project.
Some HubSpot API work is genuinely straightforward. Some is not. An honest split:
Deciding which system owns the customer record, and what happens when both change, is the hard part.
Duplicate detection and association mapping decide whether the result is usable or a mess.
HubSpot custom objects are powerful and easy to model badly in a way that is expensive to unwind later.
Joining HubSpot activity to actual revenue means reconciling two different definitions of a customer.
These integrations look simple from the outside. The work is in the detail: field mapping, conflict resolution, error recovery, and keeping everything in step as both HubSpot and the connected system change over time.
If the integration touches invoicing, stock or payroll, getting it wrong has real financial consequences. A properly built integration with monitoring and alerting is worth the upfront cost.
No, HubSpot retired its old application programming interface (API) keys in late 2022, and private app access tokens replaced them. A private app token is created inside the HubSpot account and is scoped, so it only reaches the objects you allow. Software acting for other HubSpot accounts uses OAuth instead. Because HubSpot screens move around, the official developer documentation is the reliable source for current steps.
Treat a HubSpot access token like a password, because anyone holding it can read and often write data in the HubSpot account. Do not paste the token into untrusted tools, and do not send it over email or chat. Store it somewhere the team can rotate it, and remember that a private app token only reaches the objects it has been scoped to.
The HubSpot application programming interface (API) covers contacts, companies, deals and tickets, custom objects and custom properties, pipelines and deal stages, marketing emails, forms and campaign data, quotes, line items and products, and the associations between them. With that access a business can push data into accounting or reporting systems, keep records in step across tools, and build dashboards from live HubSpot data.
For simple one-way automation, Zapier is often the right answer, because HubSpot has a native Zapier connector that handles most simple field-to-field flows. The risk comes when a no-code chain breaks: there is rarely a way to see what failed, replay the missed records, or be told before data drifts out of sync. For invoicing, stock or payroll, that gap is worth weighing first.
A HubSpot integration needs a developer for two-way sync between HubSpot deals and accounting invoices, migrating from another customer relationship management (CRM) system while HubSpot is live, custom object models, or attribution reporting across marketing and finance. Simpler jobs, such as pushing website form submissions into HubSpot or reading deal data into a reporting sheet, are achievable without specialist help.
Ask the author
Ask it here and it comes straight to Kasun, who wrote this. No sales call, no obligation, and a real answer even if the answer is that you do not need us.
Kasun Wijayamanna
Founder, replies within one business day
Tell us what you are comparing, replacing, or trying to improve. We will come back with a practical recommendation and realistic scope.
Built here. Your data stays here.
Thanks for reaching out. We will get back to you within one business day.
See what else we do