HubSpot

CRM Private app token Windmill docs

Read and update contacts, companies, deals and tickets from any Windmill script, flow or app.

Set up in 3 steps

In HubSpot, open Settings, then Integrations, then Private apps. Create an app, tick the scopes your scripts need, and copy its access token.

Open Resources, add a resource of type hubspot, and paste the token.

Fork any script below and list contacts before writing anything.

Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.

The shape of the credential every script on this page expects.

Field	Type	Required	What it is
token	string	No	Access token of a private app

A call fails on a missing scope

Scopes are fixed per private app. Edit the app in HubSpot to add the scope, then use the token again — it does not change.

Private app or the old API key?

Private apps. HubSpot retired account-wide API keys, and a private app token is scoped to what you granted it.

Is my key stored on the hub?

Never. It lives only in your own Windmill workspace, encrypted at rest.