// the find
HubSpot/hubspot-api-php
HubSpot API PHP Client Libraries for V3 version of the API
The official HubSpot PHP client for their v3 API, generated from OpenAPI specs via openapi-generator. If you're building a PHP integration with HubSpot CRM, marketing tools, or CMS, this is the correct starting point — it's maintained by HubSpot itself and covers the full API surface.
The Factory pattern with injectable Guzzle client is well-designed — you can swap in your own middleware stack without fighting the library. Built-in retry middleware handling 429s, 5xx errors, and connection failures is genuinely useful and saves everyone from reimplementing it. The escape hatch via apiRequest() for unwrapped endpoints is a practical acknowledgment that generated clients always lag behind the actual API. PHP 8.1+ requirement is reasonable and they're not pretending to support ancient versions.
This is generated code, and it shows — the method signatures are verbose to the point of pain. Getting a contact by email requires passing four null arguments before the identifier type. The model classes are pure data bags with no behavior, which means you're constructing deeply nested objects just to make a search query. The reserved-words workaround (prepend an underscore) is a leaky abstraction that will bite you when you forget why _clone works but clone doesn't. At 240 stars for an official SDK, the PHP community has clearly decided REST clients and Guzzle are good enough without a wrapper.