PHPackages                             laravel-gtm/hubspot-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. laravel-gtm/hubspot-sdk

ActiveLibrary[API Development](/categories/api)

laravel-gtm/hubspot-sdk
=======================

Laravel-ready PHP API SDK boilerplate built with Saloon (template repository).

v0.0.13(4w ago)0318↑112.5%MITPHPPHP ^8.4CI passing

Since Apr 8Pushed 3w agoCompare

[ Source](https://github.com/laravel-gtm/hubspot-sdk)[ Packagist](https://packagist.org/packages/laravel-gtm/hubspot-sdk)[ RSS](/packages/laravel-gtm-hubspot-sdk/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (27)Versions (16)Used By (0)

HubSpot SDK
===========

[](#hubspot-sdk)

A Laravel-ready PHP SDK for the HubSpot CRM API, built with [Saloon](https://docs.saloon.dev/) v4. Includes token auth, rate limiting, and typed response DTOs.

Requirements
------------

[](#requirements)

- PHP `^8.4`
- Laravel `^11.0 || ^12.0 || ^13.0` (for the optional Laravel integration)

Supported Endpoints
-------------------

[](#supported-endpoints)

SDK MethodHTTPAPI EndpointSince`createContact()`POST`/crm/v3/objects/contacts`unreleased`createCompany()`POST`/crm/v3/objects/companies`unreleased`updateCompany()`PATCH`/crm/v3/objects/companies/{companyId}`unreleased`getContact()`GET`/crm/v3/objects/contacts/{contactId}`v0.0.6`listContacts()`GET`/crm/v3/objects/contacts`v0.0.6`listContactProperties()`GET`/crm/v3/properties/contact`v0.0.6`updateContact()`PATCH`/crm/v3/objects/contacts/{contactId}`v0.0.11`getCompany()`GET`/crm/v3/objects/companies/{companyId}`v0.0.9`getCompanyContactAssociations()`GET`/crm/v3/objects/companies/{companyId}/associations/contacts`v0.0.7`searchCompanies()`POST`/crm/v3/objects/companies/search`v0.0.7`searchContacts()`POST`/crm/v3/objects/contacts/search`v0.0.9`searchDeals()`POST`/crm/v3/objects/deals/search`v0.0.9`getDeal()`GET`/crm/v3/objects/deals/{dealId}`v0.0.5`listDeals()`GET`/crm/v3/objects/deals`v0.0.1`listDealProperties()`GET`/crm/v3/properties/deal`v0.0.3`getOwner()`GET`/crm/v3/owners/{ownerId}`v0.0.7`listOwners()`GET`/crm/v3/owners`v0.0.7`listSequences()`GET`/automation/sequences/2026-03`v0.0.10`getSequence()`GET`/automation/sequences/2026-03/{sequenceId}`v0.0.10`enrollContactInSequence()`POST`/automation/sequences/2026-03/enrollments`v0.0.10Installation
------------

[](#installation)

```
composer require laravel-gtm/hubspot-sdk
```

Configuration (Laravel)
-----------------------

[](#configuration-laravel)

Publish the config (before init the tag is `hubspot-sdk-config`; after init it becomes `{your-package-slug}-config`):

```
php artisan vendor:publish --tag=hubspot-sdk-config
```

After running the init script, use your package slug in the tag (e.g. `hubspot-sdk-config`). Env keys use your chosen `ENV_PREFIX` (defaults before init use `HUBSPOT_*`):

- `HUBSPOT_BASE_URL`
- `HUBSPOT_TOKEN`
- `HUBSPOT_AUTH_HEADER`

Usage
-----

[](#usage)

### Via the service container

[](#via-the-service-container)

```
use LaravelGtm\HubspotSdk\HubspotSdk;

$sdk = app(HubspotSdk::class);
```

### Standalone

[](#standalone)

```
use LaravelGtm\HubspotSdk\HubspotSdk;

$sdk = HubspotSdk::make(
    baseUrl: 'claude',
    token: 'your-token',
);
```

### Alerting on expired tokens

[](#alerting-on-expired-tokens)

Register a callback invoked whenever a request fails with a 401 Unauthorized response, before the exception propagates. Useful for alerting on expired or revoked OAuth tokens.

```
$sdk->onUnauthorized(function (\Saloon\Http\Response $response): void {
    // e.g. notify, log, or flag the user's connection as needing reauthorization
});
```

Development
-----------

[](#development)

```
composer test        # Pest
composer analyse     # PHPStan
composer lint        # Pint (check)
composer format      # Pint (fix)
```

License
-------

[](#license)

MIT. See [LICENSE](LICENSE).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance95

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Recently: every ~22 days

Total

13

Last Release

28d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/58236685?v=4)[Devon Garbalosa](/maintainers/DGarbs51)[@DGarbs51](https://github.com/DGarbs51)

![](https://www.gravatar.com/avatar/56dcbcd0139adf900f58bc19509e785e6724dadfbfcc74f9c6769432c31686cf?d=identicon)[devethanm](/maintainers/devethanm)

---

Top Contributors

[![devethanm](https://avatars.githubusercontent.com/u/53354219?v=4)](https://github.com/devethanm "devethanm (14 commits)")[![DGarbs51](https://avatars.githubusercontent.com/u/58236685?v=4)](https://github.com/DGarbs51 "DGarbs51 (7 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/laravel-gtm-hubspot-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/laravel-gtm-hubspot-sdk/health.svg)](https://phpackages.com/packages/laravel-gtm-hubspot-sdk)
```

###  Alternatives

[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1125.1k](/packages/codebar-ag-laravel-docuware)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)