// the find
HubSpot/hubspot-api-nodejs
HubSpot API NodeJS Client Libraries for V3 version of the API
The official HubSpot v3 API client for Node.js, auto-generated from OpenAPI specs. It covers the full CRM, CMS, marketing, and automation surface area — if you're building HubSpot integrations in Node, this is the thing to use rather than rolling your own HTTP calls.
Built-in rate limiting via Bottleneck with sensible defaults (9 req/s, 6 concurrent) and separate stricter limits for search endpoints specifically — that's a real gotcha with HubSpot's API that they've handled correctly. Retry logic for 429s and 5xx with exponential backoff is configurable out of the box. The escape hatch via `apiRequest()` means you're not blocked if an endpoint isn't wrapped yet. OAuth token refresh flow is handled in the client itself, including auto-assigning the new token.
The entire `codegen/` directory being checked into the repo is a maintenance smell — it's thousands of generated files that should be built artifacts, not source. TypeScript support feels like an afterthought: the README explicitly warns that JS examples won't work in TS without changes, and sort direction syntax differs between JS and TS for no good reason. CRM Search is limited to 3 filter groups with 3 filters each — a HubSpot API constraint, but the SDK doesn't surface this as a type-level restriction, so you'll hit it at runtime. The `getAll()` convenience method does unbounded pagination under the hood with no way to set a limit or progress callback, which will silently hammer the API and your memory on large portals.