How to Get Your HubSpot API Key (and What to Build With It)

How HubSpot API access works

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.

What the HubSpot API lets you do

The HubSpot API gives you programmatic access to the core data in your account. Broadly that 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
• Associations between any of the above

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 and no-code tools

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.

Building with the HubSpot API

Connecting HubSpot to another system means working through five things, in roughly this order:

1. Authenticate using the credentials above, and store them somewhere your team can rotate
2. Map the data, deciding what moves between HubSpot and the other system, in which direction, and triggered by what
3. Handle the edge cases, such as a record that already exists on one side but not the other, or a partially completed transaction
4. Build error handling, so a failed call is retried or surfaced rather than silently dropped
5. Set up monitoring, so you find out something stopped working before it becomes an accounting problem

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.

When to bring in a developer

Some HubSpot API work is genuinely straightforward. Some is not. An honest split:

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.