|
4569
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Execute
Explain Plan
Browse Query History
View Parameters
Open Query Execution Settings…
In-Editor Results
Tx: Auto
Cancel Running Statements
Playground
jiminny
Sync Changes
Hide This Notification
Code changed:
Hide
20
1
17
2
4
Previous Highlighted Error
Next Highlighted Error
SELECT a.id, a.uuid, a.actual_start_time, o.id, o.uuid FROM opportunities o
JOIN activities a ON o.id = a.opportunity_id
WHERE a.crm_configuration_id = 39
AND a.actual_start_time > '2025-10-13'
AND a.type IN ('conference', 'softphone-inbound', 'softphone-outbound')
;
SELECT * FROM activities
WHERE crm_configuration_id = 39 and user_id = 143
and actual_start_time >= '2025-10-13'
AND type IN ('conference', 'softphone-inbound', 'softphone-outbound')
;
SELECT * FROM opportunities WHERE account_id IN (178);
select * from activities where id IN (620137, 620187, 620188, 620189, 620230);
# HS
SELECT * FROM opportunities WHERE id IN (238);
select * from activities where id IN (477,2076);
select * from users;
SELECT COUNT(*) FROM users;
SELECT COUNT(*) FROM activities;
SELECT COUNT(*) FROM opportunities;
UPDATE activities
SET
actual_start_time = '2025-12-19 09:00:00',
actual_end_time = '2025-12-19 10:30:00',
scheduled_start_time = '2025-12-19 09:00:00',
scheduled_end_time = '2025-12-19 10:30:00'
WHERE id IN (407509,407375);
select * from partners;
SELECT id, uuid, type, actual_start_time, user_id, crm_configuration_id
FROM activities
WHERE user_id = 143
AND actual_start_time >= '2025-10-13 00:00:00'
AND actual_start_time <= '2026-01-13 23:59:59'
ORDER BY actual_start_time DESC;
SELECT * FROM activities WHERE uuid_to_bin('78eda160-3086-435f-88a5-bb0c71b6008d') = uuid;
SELECT * FROM crm_layouts where crm_configuration_id = 39;
SELECT * FROM crm_layout_entities WHERE crm_layout_id = 282;
# lead_id
# account_id 177
# contact_id 3969
# opportunity_id
# stage_id 203
SELECT * FROM opportunities WHERE opportunities.crm_configuration_id = id = 282;
SELECT * FROM activities where crm_configuration_id = 39 AND type = 'conference'
AND user_id = 143 and actual_start_time >= '2025-10-13';
SELECT * FROM activities a
# JOIN opportunities o ON a.opportunity_id = o.id
WHERE a.crm_configuration_id = 39 AND a.type = 'conference'
and status = 'completed' and recording_state = 'recorded'
and a.actual_start_time >= '2025-10-13'
AND a.user_id = 143
;
select * from leads
where crm_configuration_id = 39; # 112 -> ac. 178, 109 => op. 1707
SELECT * FROM activities WHERE id IN (356013,616188,616202,616310,407509,407375,356001,356008);
SELECT * FROM activities WHERE id IN (356013,616188,616202,616310);
SELECT * FROM activities WHERE id IN (407509,407375); # leads: 112, 109 | status - 198
SELECT * FROM activities WHERE id IN (356001, 356008); # contacts:
SELECT * FROM opportunities WHERE id IN (1707);
SELECT * FROM stages where id IN (204, 198);
SELECT * FROM opportunities WHERE account_id IN (178);
SELECT * FROM opportunities WHERE crm_configuration_id = 39 AND created_at > '2025-01-01';
SELECT * FROM contacts WHERE account_id IN (178); # 4118 Musaibe, 4448 Ceco Personal
SELECT * FROM activities where crm_configuration_id = 39
AND opportunity_id IS NULL
AND is_internal = false
and status = 'completed' and recording_state = 'recorded'
AND actual_start_time >= '2025-10-13'
AND (lead_id IS NOT NULL OR contact_id IS NOT NULL OR account_id IS NOT NULL)
# AND lead_id IN (112, 109)
;
SELECT * FROM crm_profiles WHERE user_id = 143;
select * from inboxes; # 212
select * from users where id = 143; # 143
select * from inbox_email_batches where inbox_id = 212
and updated_at >= '2026-01-28 00:00:00' order by id desc;
select * from inbox_emails where inbox_id = 212
and batch_id = 95885 order by id desc;
select * from email_messages where origin_user_id = 143;
select * from activities where user_id = 143 and updated_at >= '2026-01-28 00:00:00';
select * from participants where activity_id = 620247;
select * from crm_profiles where user_id = 143;
SELECT * FROM activities WHERE uuid_to_bin('458cf915-b914-4000-b083-5687b32b2956') = uuid; # 356001
select * from transcription where activity_id = 356001; # 6943
select * from ai_prompts where transcription_id = 6943;
SELECT * FROM activity_summary_logs where activity_id = 356001;
SELECT * FROM social_accounts WHERE sociable_id = 143;
# [PASSWORD_DOTS]
SELECT * FROM activities WHERE uuid_to_bin('0164a4fb-cb95-454e-9edd-4d804e4999bd') = uuid;
# 422515 softphone tr. 8100
SELECT * FROM activities WHERE uuid_to_bin('7520add8-8d87-41a5-98e5-fc4edf96f21e') = uuid;
# 407509 conference tr. 7670 crmId: 00UD1000002J9aTMAS
select * from ai_prompts where transcription_id IN (8100, 7670);
select * from activity_summary_logs where activity_id = 407509;
select * from sidekick_settings;
select * from default_activity_types;
SELECT * FROM contacts WHERE crm_configuration_id = 39 and email = '[EMAIL]';
SELECT * FROM leads WHERE crm_configuration_id = 39 and email = '[EMAIL]';
SELECT * FROM activity_searches where user_id = 143;
SELECT * FROM groups where team_id = 1;
select * from teams where id = 1;
select * from groups where team_id = 1; # 1150 - 7e75f8025c22
select id, name, group_id, status, deleted_at, email
from users where team_id = 1 order by group_id desc ;
select * from activity_searches where id in (1977, 1978, 1979);
select * from activity_search_filters where activity_search_id IN (1977, 1978, 1979);
select * from activity_search_filters where filter = 'group_id' and value = '443f26b8-8512-437e-a9f9-7e75f8025c22'; # 10268, 10272, 10277
select * from nudges where activity_search_id IN (1977, 1978, 1979); # 877, 878, 879
INSERT INTO `activity_search_filters`
(`activity_search_id`, `filter`, `value`) VALUES
(1977, 'group_id', '443f26b8-8512-437e-a9f9-7e75f8025c22'),
(1978, 'group_id', '443f26b8-8512-437e-a9f9-7e75f8025c22'),
(1979, 'group_id', '443f26b8-8512-437e-a9f9-7e75f8025c22')
;
select * from crm_configurations where id = 39;
select sa.* from users u JOIN social_accounts sa on u.id = sa.sociable_id
where u.team_id = 1;
SELECT * FROM social_accounts WHERE sociable_id = 1635;
SELECT * FROM users WHERE id = 1635;
select * from teams where id = 1;
select * from users where team_id = 1;
select * from team_features where team_id = 1;
select * from features;
SELECT * FROM activity_searches where id = 1982; # 1981
SELECT * FROM activity_search_filters WHERE activity_search_id = 1982;
SELECT * FROM activities WHERE uuid_to_bin('e916569b-086c-4bd1-94d7-5e3802c27ccf') = uuid;
SELECT * FROM groups WHERE id = 1439;
SELECT * FROM users WHERE group_id = 1439;
select * from permissions; # 158
select * from roles;
select * from permission_role;
select * from teams where id = 1;
select * from groups g JOIN playbooks p on g.playbook_id = p.id where g.team_id = 1;
select * from groups where id = 28;
select * from playbooks where team_id = 1;
select * from playbooks where id = 179;
select * from playbook_categories where id = 1391;
select * from users where id = 143;
select * from crm_profiles where user_id = 143;
select * from activities where crm_configuration_id = 39 and type = 'conference'
and crm_provider_id IS NOT NULL ORDER by id desc;
select * from activities where id = 422003; # 00UO400000pB6fpMAC
SELECT ar.id, ar.uuid, ar.media_type, ar.status, a.type
FROM automated_report_results ar
JOIN automated_reports a ON a.id = ar.report_id
WHERE a.type = 'ask_jiminny'
LIMIT 10;
SELECT * FROM automated_reports where id = 71;
SELECT * FROM automated_report_results where report_id = 71;
UPDATE automated_reports set playbook_categories = NULL where id = 68;
SELECT * FROM automated_report_results where id = 275;
SELECT * FROM automated_reports order by id desc;
SELECT * FROM automated_report_results order by id desc;
select * from activity_searches where user_id = 143;
select * from ask_anything_prompts;
SELECT `automated_report_results`.* FROM `automated_report_results`
INNER JOIN `automated_reports`
ON `automated_report_results`.`report_id` = `automated_reports`.`id`
WHERE 1=1
AND `automated_report_results`.`generated_at` IS NOT NULL
# AND `automated_report_results`.`sent_at` IS NOT NULL
AND `automated_reports`.`team_id` = 1
AND JSON_CONTAINS(`automated_reports`.`recipients`, 143, '$."users"')
;
SELECT * FROM automated_reports where id = 67;
SELECT * FROM automated_reports where id = 42;
SELECT * FROM users WHERE id = 143; # group 28
select * from teams where id = 3143;
select * from crm_configurations where id = 500;
select * from users where name = 'Integration Account'; # 1695
SELECT * FROM social_accounts WHERE sociable_id = 1695;
select * from activities where crm_configuration_id = 39
and recording_state = 'recorded' and duration > 60
and status = 'completed' and actual_start_time >= '2025-12-01';
SELECT * FROM activities WHERE uuid_to_bin('458cf915-b914-4000-b083-5687b32b2956') = uuid;
select * from leads;
Sync Changes
Hide This Notification
Code changed:
Hide
2
70
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm\Hubspot;
use HubSpot\Client\Crm\Deals\ApiException as DealApiException;
use HubSpot\Client\Crm\Contacts\ApiException as ContactApiException;
use HubSpot\Client\Crm\Companies\ApiException as CompanyApiException;
use HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectWithAssociations as ContactsWithAssociations;
use HubSpot\Client\Crm\Companies\Model\SimplePublicObjectWithAssociations as CompaniesWithAssociations;
use HubSpot\Client\Crm\Deals\Model\SimplePublicObjectWithAssociations as DealWithAssociations;
use HubSpot\Client\Crm\Objects\Model\SimplePublicObjectInput;
use HubSpot\Client\Crm\Objects\Model\SimplePublicObjectWithAssociations as ObjectWithAssociations;
use HubSpot\Client\Crm\Pipelines\Model\Error;
use HubSpot\Client\Crm\Pipelines\Model\PipelineStage;
use HubSpot\Client\Crm\Properties\Model\Property;
use HubSpot\Discovery\Discovery;
use Jiminny\Component\Utility\Service\ProviderRateLimiter;
use Jiminny\Exceptions\CrmException;
use Jiminny\Exceptions\RateLimitException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Jobs\Crm\NoteObject;
use Jiminny\Models\Crm\Field;
use Jiminny\Services\Crm\BaseClient;
use Jiminny\Services\Crm\Hubspot\DTO\Response\Owner;
use Jiminny\Services\SocialAccountService;
use SevenShores\Hubspot\Exceptions\BadRequest;
use SevenShores\Hubspot\Exceptions\HubspotException;
use SevenShores\Hubspot\Factory;
use SevenShores\Hubspot\Http\Response;
use Jiminny\Services\Crm\Hubspot\Pagination\HubspotPaginationService;
use Throwable;
/**
* @phpstan-type CrmFieldOption array{id:string, label:string, value?:string}
*/
class Client extends BaseClient implements HubspotClientInterface
{
public const string MIN_API_VERSION = '2';
public const string BASE_URL = '[URL_WITH_CREDENTIALS] T
* @param callable(): T $apiCall
* @return T
*
* @throws RateLimitException
*/
private function executeRequest(callable $apiCall)
{
if (! $this->rateLimiter->canMakeRequest($this->config)) {
$retryAfter = $this->rateLimiter->requestAvailableIn($this->config);
$this->log->warning('[Hubspot] Rate limit exceeded, deferring request', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
]);
throw new RateLimitException(
'Hubspot rate limit reached for configuration ' . $this->config->getId(),
$retryAfter,
);
}
$this->rateLimiter->incrementRequestCount($this->config);
try {
return $apiCall();
} catch (Throwable $e) {
if ($this->isHubspotRateLimit($e)) {
$retryAfter = $this->parseRetryAfter($e);
$this->log->warning('[Hubspot] Received 429 from API', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
'reason' => $e->getMessage(),
]);
throw new RateLimitException('Hubspot returned 429', $retryAfter, $e);
}
throw $e;
}
}
public function isHubspotRateLimit(Throwable $e): bool
{
return method_exists($e, 'getCode') && (int) $e->getCode() === 429;
}
public function parseRetryAfter(Throwable $e): int
{
\Illuminate\Support\Facades\Log::channel('custom_channel')->info("parseRetryAfter");
if (method_exists($e, 'getResponseHeaders')) {
$headers = $e->getResponseHeaders() ?: [];
$value = $headers['Retry-After'] ?? $headers['retry-after'] ?? null;
if (is_array($value)) {
$value = $value[0] ?? null;
}
if (is_numeric($value)) {
return (int) $value;
}
}
$current = $e;
while ($current !== null) {
if (method_exists($current, 'getResponse')) {
$response = $current->getResponse();
if ($response !== null) {
$headers = $response->getHeaders();
}
}
$current = $current->getPrevious();
}
$this->log->info('[Hubspot] DEBUG Getting headers', [
'headers' => $headers ?? [],
]);
return 10;
}
public function getMinimumApiVersion(): string
{
return self::MIN_API_VERSION;
}
public function getInstance(): Factory
{
return new Factory([
'key' => $this->accessToken,
'oauth2' => true,
'base_url' => $this->baseUrl,
]);
}
public function getNewInstance(): Discovery
{
return \HubSpot\Factory::createWithAccessToken($this->accessToken);
}
/**
* Secondly and daily limits for Hubspot API
*
* Product Tier: Free & Starter | Professional & Enterprise | API add-on (any tier)
* Burst: 100/10 seconds | 150/10 seconds | 200/10 seconds
* Daily: 250,000 | 500,000 | 1,000,000
*
* Official documentation states: The search endpoints are rate limited to five requests per second.
* Since with 5 RPS were still hitting secondly rate limits we lowered it to 4
*/
public function getPaginatedData(array $payload, string $type, int $offset = 0): array
{
$total = 0;
$lastId = null;
$rows = [];
foreach ($this->getPaginatedDataGenerator($payload, $type, $offset, $total, $lastId) as $row) {
$rows[] = $row;
}
return ['results' => $rows, 'total' => $total, 'last_record' => $lastId];
}
/**
* @throws HubspotException
* @throws SocialAccountTokenInvalidException
* @throws BadRequest
*/
public function getPaginatedDataGenerator(
array $payload,
string $type,
int $offset = 0,
int &$total = 0,
?string &$lastRecordId = null
): \Generator {
return $this->paginationService->getPaginatedDataGenerator(
$this,
$payload,
$type,
$offset,
$total,
$lastRecordId
);
}
/**
* @throws DealApiException
* @throws CrmException
*/
public function getOpportunityById(string $crmId, array $fields): array
{
try {
// $deal = $this->executeRequest(fn () => $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$deal = $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$crmId,
implode(',', $fields),
'companies,contacts'
);
} catch (DealApiException $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $deal instanceof DealWithAssociations) {
throw new CrmException('Deal not found');
}
return [
'id' => $deal->getId(),
'properties' => $deal->getProperties(),
'associations' => $deal->getAssociations(),
];
}
/**
* Generic batch read method for HubSpot objects
*
* @param string $objectType The object type ('deals', 'companies', 'contacts')
* @param array<string> $crmIds Array of HubSpot object IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with object data
*/
private function batchReadObjects(string $objectType, array $crmIds, array $fields): array
{
if (empty($crmIds)) {
return [];
}
$this->validateBatchSize($objectType, $crmIds);
$this->ensureValidToken();
try {
$batchConfig = $this->createBatchConfiguration($objectType);
$batchReadRequest = $this->prepareBatchRequest($batchConfig, $crmIds, $fields);
$response = $batchConfig['api']->read($batchReadRequest);
$this->validateApiResponse($response, $objectType);
$results = $this->processApiResults($response);
$this->logBatchResults($objectType, $crmIds, $results);
return $results;
} catch (\Throwable $e) {
$this->handleBatchError($e, $objectType, $crmIds);
}
}
private function validateBatchSize(string $objectType, array $crmIds): void
{
if (count($crmIds) > 100) {
throw new \InvalidArgumentException("Batch size cannot exceed 100 {$objectType}");
}
}
private function createBatchConfiguration(string $objectType): array
{
$configurations = [
'deals' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Deals\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->deals()->batchApi(),
],
'companies' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Companies\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Companies\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->companies()->batchApi(),
],
'contacts' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Contacts\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->contacts()->batchApi(),
],
];
if (! isset($configurations[$objectType])) {
throw new \InvalidArgumentException("Unsupported object type: {$objectType}");
}
return $configurations[$objectType];
}
private function prepareBatchRequest(array $batchConfig, array $crmIds, array $fields): object
{
$batchReadRequest = $batchConfig['batchReadRequest'];
$inputClass = $batchConfig['inputClass'];
$inputs = array_map(function ($crmId) use ($inputClass) {
$input = new $inputClass();
$input->setId($crmId);
return $input;
}, $crmIds);
$batchReadRequest->setInputs($inputs);
$batchReadRequest->setProperties($fields);
return $batchReadRequest;
}
private function validateApiResponse($response, string $objectType): void
{
if (! $response) {
throw new CrmException("HubSpot API returned null response for {$objectType} batch read");
}
}
private function processApiResults($response): array
{
$results = [];
$responseResults = $response->getResults();
if ($responseResults) {
foreach ($responseResults as $object) {
if ($object && $object->getId()) {
$results[$object->getId()] = [
'id' => $object->getId(),
'properties' => $object->getProperties() ?: [],
];
}
}
}
return $results;
}
private function logBatchResults(string $objectType, array $crmIds, array $results): void
{
$this->log->info("[HubSpot] Batch fetched {$objectType}", [
'requested_count' => count($crmIds),
'returned_count' => count($results),
'crm_ids' => $crmIds,
]);
}
private function handleBatchError(\Throwable $e, string $objectType, array $crmIds): void
{
$errorMessage = $e->getMessage() ?: 'Unknown error';
$errorTrace = $e->getTraceAsString() ?: 'No trace available';
$this->log->error("[HubSpot] Failed to batch fetch {$objectType}", [
'crm_ids' => $crmIds,
'error' => $errorMessage,
'trace' => $errorTrace,
]);
throw new CrmException("Failed to batch fetch {$objectType}: " . $errorMessage);
}
/**
* Batch read multiple opportunities by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot deal IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with opportunity data
*/
public function getOpportunitiesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('deals', $crmIds, $fields);
}
/**
* Batch read multiple companies by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot company IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with company data
*/
public function getCompaniesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('companies', $crmIds, $fields);
}
/**
* Batch read multiple contacts by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot contact IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with contact data
*/
public function getContactsByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('contacts', $crmIds, $fields);
}
/**
* @throws CompanyApiException
* @throws CrmException
*/
public function getAccountById(string $crmId, array $fields): array
{
try {
$company = $this->getNewInstance()->crm()->companies()->basicApi()->getById(
$crmId,
implode(',', $fields),
);
} catch (CompanyApiException $e) {
$this->log->info('[Hubspot] Failed to fetch account', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $company instanceof CompaniesWithAssociations) {
throw new CrmException('Account not found');
}
return [
'id' => $company->getId(),
'properties' => $company->getProperties(),
];
}
/**
* @throws ContactApiException
* @throws CrmException
*/
public function getContactById(string $crmId, array $fields): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$crmId,
implode(',', $fields)
);
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $contact instanceof ContactsWithAssociations) {
throw new CrmException('Contact not found');
}
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
}
/**
* This is email search request that Hubspot offers as GET (more generous quota)
*/
public function getContactByEmail(string $email, array $fields = []): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$email,
implode(',', $fields),
null,
false,
'email'
);
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'email' => $email,
'reason' => $e->getMessage(),
]);
return [];
}
}
/**
* @throws CrmException
*/
public function fetchProperty(string $objectType, string $propertyId): Property
{
$result = $this->getNewInstance()->crm()->properties()->coreApi()->getByName($objectType, $propertyId);
if (! $result instanceof Property) {
$this->log->error('[Hubspot] Failed to fetch property', [
'object_type' => $objectType,
'property_id' => $propertyId,
'reason' => $result->getMessage(),
]);
throw new CrmException('Failed to fetch property');
}
return $result;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchPropertyOptions(string $objectType, string $propertyId): array
{
/** @var array<CrmFieldOption> */
return $this->fetchProperty($objectType, $propertyId)->getOptions();
}
/**
* @return array<array{id:string, label:string, deleted:bool}>
*/
public function fetchCallDispositions(): array
{
/** @var Response $response */
$response = $this->getInstance()->engagements()->getCallDispositions();
/**
* @var array<array{
* id:string,
* label:string,
* deleted: bool
* }>
*/
return $response->toArray();
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityPipelineStages(): array
{
$stages = [];
$apiResponse = $this->getNewInstance()->crm()->pipelines()->pipelinesApi()->getAll('deals');
if ($apiResponse instanceof Error) {
$this->log->error('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $apiResponse->getMessage(),
]);
return [];
}
foreach ($apiResponse->getResults() as $pipeline) {
$pipelineStages = array_map(
static function (PipelineStage $stage) {
return [
'id' => $stage->getId(),
'label' => $stage->getLabel(),
];
},
$pipeline->getStages()
);
$stages = array_merge($stages, $pipelineStages);
}
return $stages;
}
public function fetchOpportunityPipelines(): array
{
$pipelines = [];
try {
$apiResponse = $this->makeRequest('/crm/v3/pipelines/deals');
} catch (\Exception $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $e->getMessage(),
]);
return [];
}
$response = $apiResponse->toArray();
foreach ($response['results'] as $pipeline) {
$pipelines[] = [
'id' => $pipeline['id'],
'label' => $pipeline['label'],
];
}
return $pipelines;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchMeetingOutcomeFieldOptions(Field $field): array
{
return $field->getCrmProviderId() === 'meetingOutcome'
? $this->fetchMeetingOutcomeTypes()
: $this->fetchCallActivityTypes();
}
public function fetchMeetingOutcomeTypes(): array
{
return $this->extractMeetingTypeOptions(
'[URL_WITH_CREDENTIALS] Response $response */
$response = $this->getInstance()
->getClient()
->request('GET', $endpoint);
/**
* @var array<array{
* value: string,
* label: string,
* displayOrder: int
* }> $optionData
*/
$optionData = $response->toArray()['options'] ?? [];
$options = [];
foreach ($optionData as $item) {
$options[] = [
'id' => $item['value'],
'value' => $item['value'],
'label' => $item['label'],
'display_order' => $item['displayOrder'],
];
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchDispositionFieldOptions(): array
{
$options = [];
$dispositions = $this->fetchCallDispositions();
foreach ($dispositions as $disposition) {
if ($disposition['deleted'] !== false) {
continue;
}
$option['value'] = $disposition['id'];
$option['id'] = $disposition['id'];
$option['label'] = $disposition['label'];
$options[] = $option;
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityFieldOptions(Field $field): array
{
if ($field->isStageField()) {
return $this->fetchOpportunityPipelineStages();
}
if ($field->isPipelineField()) {
return $this->fetchOpportunityPipelines();
}
return $this->fetchPropertyOptions('deals', $field->getCrmProviderId());
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function makeRequest(string $endpoint, $method = 'GET', $payload = [], ?string $queryString = null)
{
$endpoint = self::BASE_URL . $endpoint;
if ($method === 'GET') {
$response = $this->getInstance()->getClient()?->request(
method: $method,
endpoint: $endpoint,
query_string: $queryString
);
} else {
$response = $this->getInstance()->getClient()->request($method, $endpoint, [
'json' => ($payload),
]);
}
$max = $response->getHeaderLine('X-HubSpot-RateLimit-Max'); // "110"
$remaining = $response->getHeaderLine('X-HubSpot-RateLimit-Remaining'); // "109"
$interval = $response->getHeaderLine('X-HubSpot-RateLimit-Interval-Milliseconds'); // "10000"
$body = json_decode((string) $response->getBody(), true);
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$max ' . PHP_EOL . print_r($max, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$remaining ' . PHP_EOL . print_r($remaining, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$interval ' . PHP_EOL . print_r($interval, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$body ' . PHP_EOL . print_r($body, true));
return $response;
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function createMeeting(array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings';
return $this->makeRequest($endpoint, 'POST', $payload);
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function updateMeeting(string $meetingId, array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings/' . $meetingId;
return $this->makeRequest($endpoint, 'PATCH', $payload);
}
/**
* @throws \Exception
*/
public function createNote(
string $body,
string $ownerId,
int $timestamp,
string $objectId,
NoteObject $noteObject
): ?string {
try {
$noteInput = new SimplePublicObjectInput([
'properties' => [
'hs_note_body' => $body,
'hubspot_owner_id' => $ownerId,
'hs_timestamp' => $timestamp,
],
]);
// Create note
$note = $this->getNewInstance()->crm()->objects()->basicApi()->create('note', $noteInput);
$this->getNewInstance()->crm()->objects()->associationsApi()->create(
'note',
$note->getId(),
$this->getNoteObject($noteObject),
$objectId,
$this->getNoteAssociationType($noteObject),
);
return $note->getId();
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to create note', [
'objectId' => $objectId,
'noteObject' => $noteObject->getObjectType(),
'reason' => $e->getMessage(),
]);
\Sentry::captureException($e);
}
return null;
}
public function updateEngagement(string $objectId, array $engagement, array $metadata): void
{
$this->getInstance()->engagements()->update($objectId, $engagement, $metadata);
}
public function getEngagementData(string $engagementId): array
{
$engagement = $this->getInstance()->engagements()->get($engagementId);
return $engagement->toArray();
}
public function createEngagement(array $engagement, array $associations, array $metadata): Response
{
return $this->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
}
public function isUnauthorizedException(\Exception $e): bool
{
// Check for specific HubSpot API exception types first
if ($e instanceof BadRequest) {
// BadRequest can contain 401 status codes
return $e->getCode() === 401;
}
// Check for HTTP client exceptions with status codes
if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
$response = $e->getResponse();
if ($response !== null) {
return $response->getStatusCode() === 401;
}
}
// Check for Guzzle HTTP exceptions
if ($e instanceof \GuzzleHttp\Exception\ClientException) {
return $e->getCode() === 401;
}
// Fallback to string matching as last resort, but be more specific
$message = strtolower($e->getMessage());
return str_contains($message, '401 unauthorized') ||
str_contains($message, 'http 401') ||
str_contains($message, 'status code 401') ||
(preg_match('/\b401\b/', $message) && str_contains($message, 'unauthorized'));
}
/**
* Validates and refreshes the access token if needed before API requests.
* This ensures long-running processes don't fail due to token expiration.
*
* @throws SocialAccountTokenInvalidException
*/
public function ensureValidToken(): void
{
if ($this->oauthAccount === null) {
return;
}
$newToken = $this->tokenManager->ensureValidToken($this->oauthAccount);
if ($newToken !== null) {
$this->accessToken = $newToken;
}
}
public function getConfig()
{
return $this->config;
}
// returns only active (archived=false)
public function getOwners(): array
{
return $this->getNewInstance()->crm()->owners()->getAll();
}
/**
* @param bool $archived
*
* @return array<Owner>|[]
*/
public function getOwnersArchived(bool $archived = true): array
{
$endpoint = '/crm/v3/owners';
$queryParams = [
'archived' => $archived ? 'true' : 'false',
];
$queryString = http_build_query($queryParams);
$owners = [];
try {
$response = $this->makeRequest(endpoint: $endpoint, queryString: $queryString);
$responseData = $response?->toArray();
foreach ($responseData['results'] as $result) {
try {
$owners[] = Owner::create($result);
} catch (Throwable $e) {
$this->log->error('[HubSpot] Failed to process owner data', [
'result' => $result,
'error' => $e->getMessage(),
]);
continue;
}
}
} catch (Throwable $e) {
$this->log->error('HubSpot] Failed to fetch owners', [
'archived' => $archived,
'error' => $e->getMessage(),
]);
return [];
}
return $owners;
}
public function getMeeting(string $engagementId): ObjectWithAssociations
{
return $this->getNewInstance()->crm()->objects()->basicApi()
->getById('meeting', $engagementId, null, 'contact,company,deal');
}
public function deleteEngagement(string $engagementId): void
{
$this->getInstance()->engagements()->delete((int) $engagementId);
}
public function getAssociationsData(array $ids, string $fromObject, string $toObject): array
{
$associationData = [];
$idChunks = array_chunk($ids, self::ASSOCIATIONS_BATCH_SIZE_LIMIT);
foreach ($idChunks as $idChunk) {
try {
$batchInput = new \HubSpot\Client\Crm\Associations\Model\BatchInputPublicObjectId();
$batchInput->setInputs(array_map(function ($id) {
$publicObjectId = new \HubSpot\Client\Crm\Associations\Model\PublicObjectId();
$publicObjectId->setId($id);
return $publicObjectId;
}, $idChunk));
$associatedObjectsData = $this
->getNewInstance()
->crm()
->associations()
->batchApi()
->read($fromObject, $toObject, $batchInput);
if ($associatedObjectsData instanceof \HubSpot\Client\Crm\Associations\Model\BatchResponsePublicAssociationMulti) {
foreach ($associatedObjectsData->getResults() as $association) {
$from = $association->getFrom()->getId();
$toAssociations = $association->getTo();
if (! empty($toAssociations)) {
$associationData[$from] = array_map(function ($item) {
return $item->getId();
}, $toAssociations);
}
}
}
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to fetch associations', [
'from_object' => $fromObject,
'to_object' => $toObject,
'reason' => $e->getMessage(),
]);
}
}
return $associationData;
}
/**
* @throws \Exception
*/
private function getNoteAssociationType(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'note_to_deal',
NoteObject::Lead, NoteObject::Contact => 'note_to_contact', // or 'note_to_lead' if your portal supports it
NoteObject::Account => 'note_to_company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
/**
* @throws \Exception
*/
private function getNoteObject(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'deal',
NoteObject::Lead, NoteObject::Contact => 'contact',
NoteObject::Account => 'company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
public function addAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/create";
return $this->makeRequest($endpoint, 'POST', $payload);
}
public function removeAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/archive";
return $this->makeRequest($endpoint, 'POST', $payload);
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – SF [jiminny@localhost]
|
NULL
|
4569
|
|
4570
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Execute
Explain Plan
Browse Query History
View Parameters
Open Query Execution Settings…
In-Editor Results
Tx: Auto
Cancel Running Statements
Playground
jiminny
Sync Changes
Hide This Notification
Code changed:
Hide
20
1
17
2
4
Previous Highlighted Error
Next Highlighted Error
SELECT a.id, a.uuid, a.actual_start_time, o.id, o.uuid FROM opportunities o
JOIN activities a ON o.id = a.opportunity_id
WHERE a.crm_configuration_id = 39
AND a.actual_start_time > '2025-10-13'
AND a.type IN ('conference', 'softphone-inbound', 'softphone-outbound')
;
SELECT * FROM activities
WHERE crm_configuration_id = 39 and user_id = 143
and actual_start_time >= '2025-10-13'
AND type IN ('conference', 'softphone-inbound', 'softphone-outbound')
;
SELECT * FROM opportunities WHERE account_id IN (178);
select * from activities where id IN (620137, 620187, 620188, 620189, 620230);
# HS
SELECT * FROM opportunities WHERE id IN (238);
select * from activities where id IN (477,2076);
select * from users;
SELECT COUNT(*) FROM users;
SELECT COUNT(*) FROM activities;
SELECT COUNT(*) FROM opportunities;
UPDATE activities
SET
actual_start_time = '2025-12-19 09:00:00',
actual_end_time = '2025-12-19 10:30:00',
scheduled_start_time = '2025-12-19 09:00:00',
scheduled_end_time = '2025-12-19 10:30:00'
WHERE id IN (407509,407375);
select * from partners;
SELECT id, uuid, type, actual_start_time, user_id, crm_configuration_id
FROM activities
WHERE user_id = 143
AND actual_start_time >= '2025-10-13 00:00:00'
AND actual_start_time <= '2026-01-13 23:59:59'
ORDER BY actual_start_time DESC;
SELECT * FROM activities WHERE uuid_to_bin('78eda160-3086-435f-88a5-bb0c71b6008d') = uuid;
SELECT * FROM crm_layouts where crm_configuration_id = 39;
SELECT * FROM crm_layout_entities WHERE crm_layout_id = 282;
# lead_id
# account_id 177
# contact_id 3969
# opportunity_id
# stage_id 203
SELECT * FROM opportunities WHERE opportunities.crm_configuration_id = id = 282;
SELECT * FROM activities where crm_configuration_id = 39 AND type = 'conference'
AND user_id = 143 and actual_start_time >= '2025-10-13';
SELECT * FROM activities a
# JOIN opportunities o ON a.opportunity_id = o.id
WHERE a.crm_configuration_id = 39 AND a.type = 'conference'
and status = 'completed' and recording_state = 'recorded'
and a.actual_start_time >= '2025-10-13'
AND a.user_id = 143
;
select * from leads
where crm_configuration_id = 39; # 112 -> ac. 178, 109 => op. 1707
SELECT * FROM activities WHERE id IN (356013,616188,616202,616310,407509,407375,356001,356008);
SELECT * FROM activities WHERE id IN (356013,616188,616202,616310);
SELECT * FROM activities WHERE id IN (407509,407375); # leads: 112, 109 | status - 198
SELECT * FROM activities WHERE id IN (356001, 356008); # contacts:
SELECT * FROM opportunities WHERE id IN (1707);
SELECT * FROM stages where id IN (204, 198);
SELECT * FROM opportunities WHERE account_id IN (178);
SELECT * FROM opportunities WHERE crm_configuration_id = 39 AND created_at > '2025-01-01';
SELECT * FROM contacts WHERE account_id IN (178); # 4118 Musaibe, 4448 Ceco Personal
SELECT * FROM activities where crm_configuration_id = 39
AND opportunity_id IS NULL
AND is_internal = false
and status = 'completed' and recording_state = 'recorded'
AND actual_start_time >= '2025-10-13'
AND (lead_id IS NOT NULL OR contact_id IS NOT NULL OR account_id IS NOT NULL)
# AND lead_id IN (112, 109)
;
SELECT * FROM crm_profiles WHERE user_id = 143;
select * from inboxes; # 212
select * from users where id = 143; # 143
select * from inbox_email_batches where inbox_id = 212
and updated_at >= '2026-01-28 00:00:00' order by id desc;
select * from inbox_emails where inbox_id = 212
and batch_id = 95885 order by id desc;
select * from email_messages where origin_user_id = 143;
select * from activities where user_id = 143 and updated_at >= '2026-01-28 00:00:00';
select * from participants where activity_id = 620247;
select * from crm_profiles where user_id = 143;
SELECT * FROM activities WHERE uuid_to_bin('458cf915-b914-4000-b083-5687b32b2956') = uuid; # 356001
select * from transcription where activity_id = 356001; # 6943
select * from ai_prompts where transcription_id = 6943;
SELECT * FROM activity_summary_logs where activity_id = 356001;
SELECT * FROM social_accounts WHERE sociable_id = 143;
# [PASSWORD_DOTS]
SELECT * FROM activities WHERE uuid_to_bin('0164a4fb-cb95-454e-9edd-4d804e4999bd') = uuid;
# 422515 softphone tr. 8100
SELECT * FROM activities WHERE uuid_to_bin('7520add8-8d87-41a5-98e5-fc4edf96f21e') = uuid;
# 407509 conference tr. 7670 crmId: 00UD1000002J9aTMAS
select * from ai_prompts where transcription_id IN (8100, 7670);
select * from activity_summary_logs where activity_id = 407509;
select * from sidekick_settings;
select * from default_activity_types;
SELECT * FROM contacts WHERE crm_configuration_id = 39 and email = '[EMAIL]';
SELECT * FROM leads WHERE crm_configuration_id = 39 and email = '[EMAIL]';
SELECT * FROM activity_searches where user_id = 143;
SELECT * FROM groups where team_id = 1;
select * from teams where id = 1;
select * from groups where team_id = 1; # 1150 - 7e75f8025c22
select id, name, group_id, status, deleted_at, email
from users where team_id = 1 order by group_id desc ;
select * from activity_searches where id in (1977, 1978, 1979);
select * from activity_search_filters where activity_search_id IN (1977, 1978, 1979);
select * from activity_search_filters where filter = 'group_id' and value = '443f26b8-8512-437e-a9f9-7e75f8025c22'; # 10268, 10272, 10277
select * from nudges where activity_search_id IN (1977, 1978, 1979); # 877, 878, 879
INSERT INTO `activity_search_filters`
(`activity_search_id`, `filter`, `value`) VALUES
(1977, 'group_id', '443f26b8-8512-437e-a9f9-7e75f8025c22'),
(1978, 'group_id', '443f26b8-8512-437e-a9f9-7e75f8025c22'),
(1979, 'group_id', '443f26b8-8512-437e-a9f9-7e75f8025c22')
;
select * from crm_configurations where id = 39;
select sa.* from users u JOIN social_accounts sa on u.id = sa.sociable_id
where u.team_id = 1;
SELECT * FROM social_accounts WHERE sociable_id = 1635;
SELECT * FROM users WHERE id = 1635;
select * from teams where id = 1;
select * from users where team_id = 1;
select * from team_features where team_id = 1;
select * from features;
SELECT * FROM activity_searches where id = 1982; # 1981
SELECT * FROM activity_search_filters WHERE activity_search_id = 1982;
SELECT * FROM activities WHERE uuid_to_bin('e916569b-086c-4bd1-94d7-5e3802c27ccf') = uuid;
SELECT * FROM groups WHERE id = 1439;
SELECT * FROM users WHERE group_id = 1439;
select * from permissions; # 158
select * from roles;
select * from permission_role;
select * from teams where id = 1;
select * from groups g JOIN playbooks p on g.playbook_id = p.id where g.team_id = 1;
select * from groups where id = 28;
select * from playbooks where team_id = 1;
select * from playbooks where id = 179;
select * from playbook_categories where id = 1391;
select * from users where id = 143;
select * from crm_profiles where user_id = 143;
select * from activities where crm_configuration_id = 39 and type = 'conference'
and crm_provider_id IS NOT NULL ORDER by id desc;
select * from activities where id = 422003; # 00UO400000pB6fpMAC
SELECT ar.id, ar.uuid, ar.media_type, ar.status, a.type
FROM automated_report_results ar
JOIN automated_reports a ON a.id = ar.report_id
WHERE a.type = 'ask_jiminny'
LIMIT 10;
SELECT * FROM automated_reports where id = 71;
SELECT * FROM automated_report_results where report_id = 71;
UPDATE automated_reports set playbook_categories = NULL where id = 68;
SELECT * FROM automated_report_results where id = 275;
SELECT * FROM automated_reports order by id desc;
SELECT * FROM automated_report_results order by id desc;
select * from activity_searches where user_id = 143;
select * from ask_anything_prompts;
SELECT `automated_report_results`.* FROM `automated_report_results`
INNER JOIN `automated_reports`
ON `automated_report_results`.`report_id` = `automated_reports`.`id`
WHERE 1=1
AND `automated_report_results`.`generated_at` IS NOT NULL
# AND `automated_report_results`.`sent_at` IS NOT NULL
AND `automated_reports`.`team_id` = 1
AND JSON_CONTAINS(`automated_reports`.`recipients`, 143, '$."users"')
;
SELECT * FROM automated_reports where id = 67;
SELECT * FROM automated_reports where id = 42;
SELECT * FROM users WHERE id = 143; # group 28
select * from teams where id = 3143;
select * from crm_configurations where id = 500;
select * from users where name = 'Integration Account'; # 1695
SELECT * FROM social_accounts WHERE sociable_id = 1695;
select * from activities where crm_configuration_id = 39
and recording_state = 'recorded' and duration > 60
and status = 'completed' and actual_start_time >= '2025-12-01';
SELECT * FROM activities WHERE uuid_to_bin('458cf915-b914-4000-b083-5687b32b2956') = uuid;
select * from leads;
Sync Changes
Hide This Notification
Code changed:
Hide
2
70
2
Previous Highlighted Error
Next Highlighted Error
<?php
declare(strict_types=1);
namespace Jiminny\Services\Crm\Hubspot;
use HubSpot\Client\Crm\Deals\ApiException as DealApiException;
use HubSpot\Client\Crm\Contacts\ApiException as ContactApiException;
use HubSpot\Client\Crm\Companies\ApiException as CompanyApiException;
use HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectWithAssociations as ContactsWithAssociations;
use HubSpot\Client\Crm\Companies\Model\SimplePublicObjectWithAssociations as CompaniesWithAssociations;
use HubSpot\Client\Crm\Deals\Model\SimplePublicObjectWithAssociations as DealWithAssociations;
use HubSpot\Client\Crm\Objects\Model\SimplePublicObjectInput;
use HubSpot\Client\Crm\Objects\Model\SimplePublicObjectWithAssociations as ObjectWithAssociations;
use HubSpot\Client\Crm\Pipelines\Model\Error;
use HubSpot\Client\Crm\Pipelines\Model\PipelineStage;
use HubSpot\Client\Crm\Properties\Model\Property;
use HubSpot\Discovery\Discovery;
use Jiminny\Component\Utility\Service\ProviderRateLimiter;
use Jiminny\Exceptions\CrmException;
use Jiminny\Exceptions\RateLimitException;
use Jiminny\Exceptions\SocialAccountTokenInvalidException;
use Jiminny\Jobs\Crm\NoteObject;
use Jiminny\Models\Crm\Field;
use Jiminny\Services\Crm\BaseClient;
use Jiminny\Services\Crm\Hubspot\DTO\Response\Owner;
use Jiminny\Services\SocialAccountService;
use SevenShores\Hubspot\Exceptions\BadRequest;
use SevenShores\Hubspot\Exceptions\HubspotException;
use SevenShores\Hubspot\Factory;
use SevenShores\Hubspot\Http\Response;
use Jiminny\Services\Crm\Hubspot\Pagination\HubspotPaginationService;
use Throwable;
/**
* @phpstan-type CrmFieldOption array{id:string, label:string, value?:string}
*/
class Client extends BaseClient implements HubspotClientInterface
{
public const string MIN_API_VERSION = '2';
public const string BASE_URL = '[URL_WITH_CREDENTIALS] T
* @param callable(): T $apiCall
* @return T
*
* @throws RateLimitException
*/
private function executeRequest(callable $apiCall)
{
if (! $this->rateLimiter->canMakeRequest($this->config)) {
$retryAfter = $this->rateLimiter->requestAvailableIn($this->config);
$this->log->warning('[Hubspot] Rate limit exceeded, deferring request', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
]);
throw new RateLimitException(
'Hubspot rate limit reached for configuration ' . $this->config->getId(),
$retryAfter,
);
}
$this->rateLimiter->incrementRequestCount($this->config);
try {
return $apiCall();
} catch (Throwable $e) {
if ($this->isHubspotRateLimit($e)) {
$retryAfter = $this->parseRetryAfter($e);
$this->log->warning('[Hubspot] Received 429 from API', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
'reason' => $e->getMessage(),
]);
throw new RateLimitException('Hubspot returned 429', $retryAfter, $e);
}
throw $e;
}
}
public function isHubspotRateLimit(Throwable $e): bool
{
return method_exists($e, 'getCode') && (int) $e->getCode() === 429;
}
public function parseRetryAfter(Throwable $e): int
{
\Illuminate\Support\Facades\Log::channel('custom_channel')->info("parseRetryAfter");
if (method_exists($e, 'getResponseHeaders')) {
$headers = $e->getResponseHeaders() ?: [];
$value = $headers['Retry-After'] ?? $headers['retry-after'] ?? null;
if (is_array($value)) {
$value = $value[0] ?? null;
}
if (is_numeric($value)) {
return (int) $value;
}
}
$current = $e;
while ($current !== null) {
if (method_exists($current, 'getResponse')) {
$response = $current->getResponse();
if ($response !== null) {
$headers = $response->getHeaders();
}
}
$current = $current->getPrevious();
}
$this->log->info('[Hubspot] DEBUG Getting headers', [
'headers' => $headers ?? [],
]);
return 10;
}
public function getMinimumApiVersion(): string
{
return self::MIN_API_VERSION;
}
public function getInstance(): Factory
{
return new Factory([
'key' => $this->accessToken,
'oauth2' => true,
'base_url' => $this->baseUrl,
]);
}
public function getNewInstance(): Discovery
{
return \HubSpot\Factory::createWithAccessToken($this->accessToken);
}
/**
* Secondly and daily limits for Hubspot API
*
* Product Tier: Free & Starter | Professional & Enterprise | API add-on (any tier)
* Burst: 100/10 seconds | 150/10 seconds | 200/10 seconds
* Daily: 250,000 | 500,000 | 1,000,000
*
* Official documentation states: The search endpoints are rate limited to five requests per second.
* Since with 5 RPS were still hitting secondly rate limits we lowered it to 4
*/
public function getPaginatedData(array $payload, string $type, int $offset = 0): array
{
$total = 0;
$lastId = null;
$rows = [];
foreach ($this->getPaginatedDataGenerator($payload, $type, $offset, $total, $lastId) as $row) {
$rows[] = $row;
}
return ['results' => $rows, 'total' => $total, 'last_record' => $lastId];
}
/**
* @throws HubspotException
* @throws SocialAccountTokenInvalidException
* @throws BadRequest
*/
public function getPaginatedDataGenerator(
array $payload,
string $type,
int $offset = 0,
int &$total = 0,
?string &$lastRecordId = null
): \Generator {
return $this->paginationService->getPaginatedDataGenerator(
$this,
$payload,
$type,
$offset,
$total,
$lastRecordId
);
}
/**
* @throws DealApiException
* @throws CrmException
*/
public function getOpportunityById(string $crmId, array $fields): array
{
try {
// $deal = $this->executeRequest(fn () => $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$deal = $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$crmId,
implode(',', $fields),
'companies,contacts'
);
} catch (DealApiException $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $deal instanceof DealWithAssociations) {
throw new CrmException('Deal not found');
}
return [
'id' => $deal->getId(),
'properties' => $deal->getProperties(),
'associations' => $deal->getAssociations(),
];
}
/**
* Generic batch read method for HubSpot objects
*
* @param string $objectType The object type ('deals', 'companies', 'contacts')
* @param array<string> $crmIds Array of HubSpot object IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with object data
*/
private function batchReadObjects(string $objectType, array $crmIds, array $fields): array
{
if (empty($crmIds)) {
return [];
}
$this->validateBatchSize($objectType, $crmIds);
$this->ensureValidToken();
try {
$batchConfig = $this->createBatchConfiguration($objectType);
$batchReadRequest = $this->prepareBatchRequest($batchConfig, $crmIds, $fields);
$response = $batchConfig['api']->read($batchReadRequest);
$this->validateApiResponse($response, $objectType);
$results = $this->processApiResults($response);
$this->logBatchResults($objectType, $crmIds, $results);
return $results;
} catch (\Throwable $e) {
$this->handleBatchError($e, $objectType, $crmIds);
}
}
private function validateBatchSize(string $objectType, array $crmIds): void
{
if (count($crmIds) > 100) {
throw new \InvalidArgumentException("Batch size cannot exceed 100 {$objectType}");
}
}
private function createBatchConfiguration(string $objectType): array
{
$configurations = [
'deals' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Deals\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->deals()->batchApi(),
],
'companies' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Companies\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Companies\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->companies()->batchApi(),
],
'contacts' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Contacts\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->contacts()->batchApi(),
],
];
if (! isset($configurations[$objectType])) {
throw new \InvalidArgumentException("Unsupported object type: {$objectType}");
}
return $configurations[$objectType];
}
private function prepareBatchRequest(array $batchConfig, array $crmIds, array $fields): object
{
$batchReadRequest = $batchConfig['batchReadRequest'];
$inputClass = $batchConfig['inputClass'];
$inputs = array_map(function ($crmId) use ($inputClass) {
$input = new $inputClass();
$input->setId($crmId);
return $input;
}, $crmIds);
$batchReadRequest->setInputs($inputs);
$batchReadRequest->setProperties($fields);
return $batchReadRequest;
}
private function validateApiResponse($response, string $objectType): void
{
if (! $response) {
throw new CrmException("HubSpot API returned null response for {$objectType} batch read");
}
}
private function processApiResults($response): array
{
$results = [];
$responseResults = $response->getResults();
if ($responseResults) {
foreach ($responseResults as $object) {
if ($object && $object->getId()) {
$results[$object->getId()] = [
'id' => $object->getId(),
'properties' => $object->getProperties() ?: [],
];
}
}
}
return $results;
}
private function logBatchResults(string $objectType, array $crmIds, array $results): void
{
$this->log->info("[HubSpot] Batch fetched {$objectType}", [
'requested_count' => count($crmIds),
'returned_count' => count($results),
'crm_ids' => $crmIds,
]);
}
private function handleBatchError(\Throwable $e, string $objectType, array $crmIds): void
{
$errorMessage = $e->getMessage() ?: 'Unknown error';
$errorTrace = $e->getTraceAsString() ?: 'No trace available';
$this->log->error("[HubSpot] Failed to batch fetch {$objectType}", [
'crm_ids' => $crmIds,
'error' => $errorMessage,
'trace' => $errorTrace,
]);
throw new CrmException("Failed to batch fetch {$objectType}: " . $errorMessage);
}
/**
* Batch read multiple opportunities by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot deal IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with opportunity data
*/
public function getOpportunitiesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('deals', $crmIds, $fields);
}
/**
* Batch read multiple companies by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot company IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with company data
*/
public function getCompaniesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('companies', $crmIds, $fields);
}
/**
* Batch read multiple contacts by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot contact IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with contact data
*/
public function getContactsByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('contacts', $crmIds, $fields);
}
/**
* @throws CompanyApiException
* @throws CrmException
*/
public function getAccountById(string $crmId, array $fields): array
{
try {
$company = $this->getNewInstance()->crm()->companies()->basicApi()->getById(
$crmId,
implode(',', $fields),
);
} catch (CompanyApiException $e) {
$this->log->info('[Hubspot] Failed to fetch account', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $company instanceof CompaniesWithAssociations) {
throw new CrmException('Account not found');
}
return [
'id' => $company->getId(),
'properties' => $company->getProperties(),
];
}
/**
* @throws ContactApiException
* @throws CrmException
*/
public function getContactById(string $crmId, array $fields): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$crmId,
implode(',', $fields)
);
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $contact instanceof ContactsWithAssociations) {
throw new CrmException('Contact not found');
}
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
}
/**
* This is email search request that Hubspot offers as GET (more generous quota)
*/
public function getContactByEmail(string $email, array $fields = []): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$email,
implode(',', $fields),
null,
false,
'email'
);
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'email' => $email,
'reason' => $e->getMessage(),
]);
return [];
}
}
/**
* @throws CrmException
*/
public function fetchProperty(string $objectType, string $propertyId): Property
{
$result = $this->getNewInstance()->crm()->properties()->coreApi()->getByName($objectType, $propertyId);
if (! $result instanceof Property) {
$this->log->error('[Hubspot] Failed to fetch property', [
'object_type' => $objectType,
'property_id' => $propertyId,
'reason' => $result->getMessage(),
]);
throw new CrmException('Failed to fetch property');
}
return $result;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchPropertyOptions(string $objectType, string $propertyId): array
{
/** @var array<CrmFieldOption> */
return $this->fetchProperty($objectType, $propertyId)->getOptions();
}
/**
* @return array<array{id:string, label:string, deleted:bool}>
*/
public function fetchCallDispositions(): array
{
/** @var Response $response */
$response = $this->getInstance()->engagements()->getCallDispositions();
/**
* @var array<array{
* id:string,
* label:string,
* deleted: bool
* }>
*/
return $response->toArray();
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityPipelineStages(): array
{
$stages = [];
$apiResponse = $this->getNewInstance()->crm()->pipelines()->pipelinesApi()->getAll('deals');
if ($apiResponse instanceof Error) {
$this->log->error('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $apiResponse->getMessage(),
]);
return [];
}
foreach ($apiResponse->getResults() as $pipeline) {
$pipelineStages = array_map(
static function (PipelineStage $stage) {
return [
'id' => $stage->getId(),
'label' => $stage->getLabel(),
];
},
$pipeline->getStages()
);
$stages = array_merge($stages, $pipelineStages);
}
return $stages;
}
public function fetchOpportunityPipelines(): array
{
$pipelines = [];
try {
$apiResponse = $this->makeRequest('/crm/v3/pipelines/deals');
} catch (\Exception $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $e->getMessage(),
]);
return [];
}
$response = $apiResponse->toArray();
foreach ($response['results'] as $pipeline) {
$pipelines[] = [
'id' => $pipeline['id'],
'label' => $pipeline['label'],
];
}
return $pipelines;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchMeetingOutcomeFieldOptions(Field $field): array
{
return $field->getCrmProviderId() === 'meetingOutcome'
? $this->fetchMeetingOutcomeTypes()
: $this->fetchCallActivityTypes();
}
public function fetchMeetingOutcomeTypes(): array
{
return $this->extractMeetingTypeOptions(
'[URL_WITH_CREDENTIALS] Response $response */
$response = $this->getInstance()
->getClient()
->request('GET', $endpoint);
/**
* @var array<array{
* value: string,
* label: string,
* displayOrder: int
* }> $optionData
*/
$optionData = $response->toArray()['options'] ?? [];
$options = [];
foreach ($optionData as $item) {
$options[] = [
'id' => $item['value'],
'value' => $item['value'],
'label' => $item['label'],
'display_order' => $item['displayOrder'],
];
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchDispositionFieldOptions(): array
{
$options = [];
$dispositions = $this->fetchCallDispositions();
foreach ($dispositions as $disposition) {
if ($disposition['deleted'] !== false) {
continue;
}
$option['value'] = $disposition['id'];
$option['id'] = $disposition['id'];
$option['label'] = $disposition['label'];
$options[] = $option;
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityFieldOptions(Field $field): array
{
if ($field->isStageField()) {
return $this->fetchOpportunityPipelineStages();
}
if ($field->isPipelineField()) {
return $this->fetchOpportunityPipelines();
}
return $this->fetchPropertyOptions('deals', $field->getCrmProviderId());
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function makeRequest(string $endpoint, $method = 'GET', $payload = [], ?string $queryString = null)
{
$endpoint = self::BASE_URL . $endpoint;
if ($method === 'GET') {
$response = $this->getInstance()->getClient()?->request(
method: $method,
endpoint: $endpoint,
query_string: $queryString
);
} else {
$response = $this->getInstance()->getClient()->request($method, $endpoint, [
'json' => ($payload),
]);
}
$max = $response->getHeaderLine('X-HubSpot-RateLimit-Max'); // "110"
$remaining = $response->getHeaderLine('X-HubSpot-RateLimit-Remaining'); // "109"
$interval = $response->getHeaderLine('X-HubSpot-RateLimit-Interval-Milliseconds'); // "10000"
$body = json_decode((string) $response->getBody(), true);
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$max ' . PHP_EOL . print_r($max, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$remaining ' . PHP_EOL . print_r($remaining, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$interval ' . PHP_EOL . print_r($interval, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$body ' . PHP_EOL . print_r($body, true));
return $response;
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function createMeeting(array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings';
return $this->makeRequest($endpoint, 'POST', $payload);
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function updateMeeting(string $meetingId, array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings/' . $meetingId;
return $this->makeRequest($endpoint, 'PATCH', $payload);
}
/**
* @throws \Exception
*/
public function createNote(
string $body,
string $ownerId,
int $timestamp,
string $objectId,
NoteObject $noteObject
): ?string {
try {
$noteInput = new SimplePublicObjectInput([
'properties' => [
'hs_note_body' => $body,
'hubspot_owner_id' => $ownerId,
'hs_timestamp' => $timestamp,
],
]);
// Create note
$note = $this->getNewInstance()->crm()->objects()->basicApi()->create('note', $noteInput);
$this->getNewInstance()->crm()->objects()->associationsApi()->create(
'note',
$note->getId(),
$this->getNoteObject($noteObject),
$objectId,
$this->getNoteAssociationType($noteObject),
);
return $note->getId();
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to create note', [
'objectId' => $objectId,
'noteObject' => $noteObject->getObjectType(),
'reason' => $e->getMessage(),
]);
\Sentry::captureException($e);
}
return null;
}
public function updateEngagement(string $objectId, array $engagement, array $metadata): void
{
$this->getInstance()->engagements()->update($objectId, $engagement, $metadata);
}
public function getEngagementData(string $engagementId): array
{
$engagement = $this->getInstance()->engagements()->get($engagementId);
return $engagement->toArray();
}
public function createEngagement(array $engagement, array $associations, array $metadata): Response
{
return $this->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
}
public function isUnauthorizedException(\Exception $e): bool
{
// Check for specific HubSpot API exception types first
if ($e instanceof BadRequest) {
// BadRequest can contain 401 status codes
return $e->getCode() === 401;
}
// Check for HTTP client exceptions with status codes
if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
$response = $e->getResponse();
if ($response !== null) {
return $response->getStatusCode() === 401;
}
}
// Check for Guzzle HTTP exceptions
if ($e instanceof \GuzzleHttp\Exception\ClientException) {
return $e->getCode() === 401;
}
// Fallback to string matching as last resort, but be more specific
$message = strtolower($e->getMessage());
return str_contains($message, '401 unauthorized') ||
str_contains($message, 'http 401') ||
str_contains($message, 'status code 401') ||
(preg_match('/\b401\b/', $message) && str_contains($message, 'unauthorized'));
}
/**
* Validates and refreshes the access token if needed before API requests.
* This ensures long-running processes don't fail due to token expiration.
*
* @throws SocialAccountTokenInvalidException
*/
public function ensureValidToken(): void
{
if ($this->oauthAccount === null) {
return;
}
$newToken = $this->tokenManager->ensureValidToken($this->oauthAccount);
if ($newToken !== null) {
$this->accessToken = $newToken;
}
}
public function getConfig()
{
return $this->config;
}
// returns only active (archived=false)
public function getOwners(): array
{
return $this->getNewInstance()->crm()->owners()->getAll();
}
/**
* @param bool $archived
*
* @return array<Owner>|[]
*/
public function getOwnersArchived(bool $archived = true): array
{
$endpoint = '/crm/v3/owners';
$queryParams = [
'archived' => $archived ? 'true' : 'false',
];
$queryString = http_build_query($queryParams);
$owners = [];
try {
$response = $this->makeRequest(endpoint: $endpoint, queryString: $queryString);
$responseData = $response?->toArray();
foreach ($responseData['results'] as $result) {
try {
$owners[] = Owner::create($result);
} catch (Throwable $e) {
$this->log->error('[HubSpot] Failed to process owner data', [
'result' => $result,
'error' => $e->getMessage(),
]);
continue;
}
}
} catch (Throwable $e) {
$this->log->error('HubSpot] Failed to fetch owners', [
'archived' => $archived,
'error' => $e->getMessage(),
]);
return [];
}
return $owners;
}
public function getMeeting(string $engagementId): ObjectWithAssociations
{
return $this->getNewInstance()->crm()->objects()->basicApi()
->getById('meeting', $engagementId, null, 'contact,company,deal');
}
public function deleteEngagement(string $engagementId): void
{
$this->getInstance()->engagements()->delete((int) $engagementId);
}
public function getAssociationsData(array $ids, string $fromObject, string $toObject): array
{
$associationData = [];
$idChunks = array_chunk($ids, self::ASSOCIATIONS_BATCH_SIZE_LIMIT);
foreach ($idChunks as $idChunk) {
try {
$batchInput = new \HubSpot\Client\Crm\Associations\Model\BatchInputPublicObjectId();
$batchInput->setInputs(array_map(function ($id) {
$publicObjectId = new \HubSpot\Client\Crm\Associations\Model\PublicObjectId();
$publicObjectId->setId($id);
return $publicObjectId;
}, $idChunk));
$associatedObjectsData = $this
->getNewInstance()
->crm()
->associations()
->batchApi()
->read($fromObject, $toObject, $batchInput);
if ($associatedObjectsData instanceof \HubSpot\Client\Crm\Associations\Model\BatchResponsePublicAssociationMulti) {
foreach ($associatedObjectsData->getResults() as $association) {
$from = $association->getFrom()->getId();
$toAssociations = $association->getTo();
if (! empty($toAssociations)) {
$associationData[$from] = array_map(function ($item) {
return $item->getId();
}, $toAssociations);
}
}
}
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to fetch associations', [
'from_object' => $fromObject,
'to_object' => $toObject,
'reason' => $e->getMessage(),
]);
}
}
return $associationData;
}
/**
* @throws \Exception
*/
private function getNoteAssociationType(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'note_to_deal',
NoteObject::Lead, NoteObject::Contact => 'note_to_contact', // or 'note_to_lead' if your portal supports it
NoteObject::Account => 'note_to_company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
/**
* @throws \Exception
*/
private function getNoteObject(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'deal',
NoteObject::Lead, NoteObject::Contact => 'contact',
NoteObject::Account => 'company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
public function addAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/create";
return $this->makeRequest($endpoint, 'POST', $payload);
}
public function removeAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/archive";
return $this->makeRequest($endpoint, 'POST', $payload);
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – SF [jiminny@localhost]
|
NULL
|
4570
|
|
4571
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Execute
Explain Plan
Browse Query History
View Parameters
Open Query Execution Settings…
In-Editor Results
Tx: Auto
Cancel Running Statements
Playground
jiminny
Sync Changes
Hide This Notification
Code changed:
Hide
6
1
6
Previous Highlighted Error
Next Highlighted Error
# [PASSWORD_DOTS] HS [PASSWORD_DOTS]
select * from teams where id = 2; # 2
select * from features; # 2
select * from team_features where team_id = 2; # 2
select * from crm_configurations where id = 2; # 2
select * from users where team_id = 2; #
select * from playbooks where team_id = 2; # event 38
select * from playbook_categories where playbook_id = 38; #
SELECT * FROM activities WHERE crm_configuration_id = 2 and crm_provider_id is not null order by id desc;
[URL_WITH_CREDENTIALS] CrmFieldOption array{id:string, label:string, value?:string}
*/
class Client extends BaseClient implements HubspotClientInterface
{
public const string MIN_API_VERSION = '2';
public const string BASE_URL = '[URL_WITH_CREDENTIALS] T
* @param callable(): T $apiCall
* @return T
*
* @throws RateLimitException
*/
private function executeRequest(callable $apiCall)
{
if (! $this->rateLimiter->canMakeRequest($this->config)) {
$retryAfter = $this->rateLimiter->requestAvailableIn($this->config);
$this->log->warning('[Hubspot] Rate limit exceeded, deferring request', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
]);
throw new RateLimitException(
'Hubspot rate limit reached for configuration ' . $this->config->getId(),
$retryAfter,
);
}
$this->rateLimiter->incrementRequestCount($this->config);
try {
return $apiCall();
} catch (Throwable $e) {
if ($this->isHubspotRateLimit($e)) {
$retryAfter = $this->parseRetryAfter($e);
$this->log->warning('[Hubspot] Received 429 from API', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
'reason' => $e->getMessage(),
]);
throw new RateLimitException('Hubspot returned 429', $retryAfter, $e);
}
throw $e;
}
}
public function isHubspotRateLimit(Throwable $e): bool
{
return method_exists($e, 'getCode') && (int) $e->getCode() === 429;
}
public function parseRetryAfter(Throwable $e): int
{
\Illuminate\Support\Facades\Log::channel('custom_channel')->info("parseRetryAfter");
if (method_exists($e, 'getResponseHeaders')) {
$headers = $e->getResponseHeaders() ?: [];
$value = $headers['Retry-After'] ?? $headers['retry-after'] ?? null;
if (is_array($value)) {
$value = $value[0] ?? null;
}
if (is_numeric($value)) {
return (int) $value;
}
}
$current = $e;
while ($current !== null) {
if (method_exists($current, 'getResponse')) {
$response = $current->getResponse();
if ($response !== null) {
$headers = $response->getHeaders();
}
}
$current = $current->getPrevious();
}
$this->log->info('[Hubspot] DEBUG Getting headers', [
'headers' => $headers ?? [],
]);
return 10;
}
public function getMinimumApiVersion(): string
{
return self::MIN_API_VERSION;
}
public function getInstance(): Factory
{
return new Factory([
'key' => $this->accessToken,
'oauth2' => true,
'base_url' => $this->baseUrl,
]);
}
public function getNewInstance(): Discovery
{
return \HubSpot\Factory::createWithAccessToken($this->accessToken);
}
/**
* Secondly and daily limits for Hubspot API
*
* Product Tier: Free & Starter | Professional & Enterprise | API add-on (any tier)
* Burst: 100/10 seconds | 150/10 seconds | 200/10 seconds
* Daily: 250,000 | 500,000 | 1,000,000
*
* Official documentation states: The search endpoints are rate limited to five requests per second.
* Since with 5 RPS were still hitting secondly rate limits we lowered it to 4
*/
public function getPaginatedData(array $payload, string $type, int $offset = 0): array
{
$total = 0;
$lastId = null;
$rows = [];
foreach ($this->getPaginatedDataGenerator($payload, $type, $offset, $total, $lastId) as $row) {
$rows[] = $row;
}
return ['results' => $rows, 'total' => $total, 'last_record' => $lastId];
}
/**
* @throws HubspotException
* @throws SocialAccountTokenInvalidException
* @throws BadRequest
*/
public function getPaginatedDataGenerator(
array $payload,
string $type,
int $offset = 0,
int &$total = 0,
?string &$lastRecordId = null
): \Generator {
return $this->paginationService->getPaginatedDataGenerator(
$this,
$payload,
$type,
$offset,
$total,
$lastRecordId
);
}
/**
* @throws DealApiException
* @throws CrmException
*/
public function getOpportunityById(string $crmId, array $fields): array
{
try {
// $deal = $this->executeRequest(fn () => $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$deal = $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$crmId,
implode(',', $fields),
'companies,contacts'
);
} catch (DealApiException $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $deal instanceof DealWithAssociations) {
throw new CrmException('Deal not found');
}
return [
'id' => $deal->getId(),
'properties' => $deal->getProperties(),
'associations' => $deal->getAssociations(),
];
}
/**
* Generic batch read method for HubSpot objects
*
* @param string $objectType The object type ('deals', 'companies', 'contacts')
* @param array<string> $crmIds Array of HubSpot object IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with object data
*/
private function batchReadObjects(string $objectType, array $crmIds, array $fields): array
{
if (empty($crmIds)) {
return [];
}
$this->validateBatchSize($objectType, $crmIds);
$this->ensureValidToken();
try {
$batchConfig = $this->createBatchConfiguration($objectType);
$batchReadRequest = $this->prepareBatchRequest($batchConfig, $crmIds, $fields);
$response = $batchConfig['api']->read($batchReadRequest);
$this->validateApiResponse($response, $objectType);
$results = $this->processApiResults($response);
$this->logBatchResults($objectType, $crmIds, $results);
return $results;
} catch (\Throwable $e) {
$this->handleBatchError($e, $objectType, $crmIds);
}
}
private function validateBatchSize(string $objectType, array $crmIds): void
{
if (count($crmIds) > 100) {
throw new \InvalidArgumentException("Batch size cannot exceed 100 {$objectType}");
}
}
private function createBatchConfiguration(string $objectType): array
{
$configurations = [
'deals' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Deals\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->deals()->batchApi(),
],
'companies' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Companies\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Companies\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->companies()->batchApi(),
],
'contacts' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Contacts\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->contacts()->batchApi(),
],
];
if (! isset($configurations[$objectType])) {
throw new \InvalidArgumentException("Unsupported object type: {$objectType}");
}
return $configurations[$objectType];
}
private function prepareBatchRequest(array $batchConfig, array $crmIds, array $fields): object
{
$batchReadRequest = $batchConfig['batchReadRequest'];
$inputClass = $batchConfig['inputClass'];
$inputs = array_map(function ($crmId) use ($inputClass) {
$input = new $inputClass();
$input->setId($crmId);
return $input;
}, $crmIds);
$batchReadRequest->setInputs($inputs);
$batchReadRequest->setProperties($fields);
return $batchReadRequest;
}
private function validateApiResponse($response, string $objectType): void
{
if (! $response) {
throw new CrmException("HubSpot API returned null response for {$objectType} batch read");
}
}
private function processApiResults($response): array
{
$results = [];
$responseResults = $response->getResults();
if ($responseResults) {
foreach ($responseResults as $object) {
if ($object && $object->getId()) {
$results[$object->getId()] = [
'id' => $object->getId(),
'properties' => $object->getProperties() ?: [],
];
}
}
}
return $results;
}
private function logBatchResults(string $objectType, array $crmIds, array $results): void
{
$this->log->info("[HubSpot] Batch fetched {$objectType}", [
'requested_count' => count($crmIds),
'returned_count' => count($results),
'crm_ids' => $crmIds,
]);
}
private function handleBatchError(\Throwable $e, string $objectType, array $crmIds): void
{
$errorMessage = $e->getMessage() ?: 'Unknown error';
$errorTrace = $e->getTraceAsString() ?: 'No trace available';
$this->log->error("[HubSpot] Failed to batch fetch {$objectType}", [
'crm_ids' => $crmIds,
'error' => $errorMessage,
'trace' => $errorTrace,
]);
throw new CrmException("Failed to batch fetch {$objectType}: " . $errorMessage);
}
/**
* Batch read multiple opportunities by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot deal IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with opportunity data
*/
public function getOpportunitiesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('deals', $crmIds, $fields);
}
/**
* Batch read multiple companies by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot company IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with company data
*/
public function getCompaniesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('companies', $crmIds, $fields);
}
/**
* Batch read multiple contacts by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot contact IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with contact data
*/
public function getContactsByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('contacts', $crmIds, $fields);
}
/**
* @throws CompanyApiException
* @throws CrmException
*/
public function getAccountById(string $crmId, array $fields): array
{
try {
$company = $this->getNewInstance()->crm()->companies()->basicApi()->getById(
$crmId,
implode(',', $fields),
);
} catch (CompanyApiException $e) {
$this->log->info('[Hubspot] Failed to fetch account', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $company instanceof CompaniesWithAssociations) {
throw new CrmException('Account not found');
}
return [
'id' => $company->getId(),
'properties' => $company->getProperties(),
];
}
/**
* @throws ContactApiException
* @throws CrmException
*/
public function getContactById(string $crmId, array $fields): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$crmId,
implode(',', $fields)
);
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $contact instanceof ContactsWithAssociations) {
throw new CrmException('Contact not found');
}
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
}
/**
* This is email search request that Hubspot offers as GET (more generous quota)
*/
public function getContactByEmail(string $email, array $fields = []): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$email,
implode(',', $fields),
null,
false,
'email'
);
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'email' => $email,
'reason' => $e->getMessage(),
]);
return [];
}
}
/**
* @throws CrmException
*/
public function fetchProperty(string $objectType, string $propertyId): Property
{
$result = $this->getNewInstance()->crm()->properties()->coreApi()->getByName($objectType, $propertyId);
if (! $result instanceof Property) {
$this->log->error('[Hubspot] Failed to fetch property', [
'object_type' => $objectType,
'property_id' => $propertyId,
'reason' => $result->getMessage(),
]);
throw new CrmException('Failed to fetch property');
}
return $result;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchPropertyOptions(string $objectType, string $propertyId): array
{
/** @var array<CrmFieldOption> */
return $this->fetchProperty($objectType, $propertyId)->getOptions();
}
/**
* @return array<array{id:string, label:string, deleted:bool}>
*/
public function fetchCallDispositions(): array
{
/** @var Response $response */
$response = $this->getInstance()->engagements()->getCallDispositions();
/**
* @var array<array{
* id:string,
* label:string,
* deleted: bool
* }>
*/
return $response->toArray();
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityPipelineStages(): array
{
$stages = [];
$apiResponse = $this->getNewInstance()->crm()->pipelines()->pipelinesApi()->getAll('deals');
if ($apiResponse instanceof Error) {
$this->log->error('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $apiResponse->getMessage(),
]);
return [];
}
foreach ($apiResponse->getResults() as $pipeline) {
$pipelineStages = array_map(
static function (PipelineStage $stage) {
return [
'id' => $stage->getId(),
'label' => $stage->getLabel(),
];
},
$pipeline->getStages()
);
$stages = array_merge($stages, $pipelineStages);
}
return $stages;
}
public function fetchOpportunityPipelines(): array
{
$pipelines = [];
try {
$apiResponse = $this->makeRequest('/crm/v3/pipelines/deals');
} catch (\Exception $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $e->getMessage(),
]);
return [];
}
$response = $apiResponse->toArray();
foreach ($response['results'] as $pipeline) {
$pipelines[] = [
'id' => $pipeline['id'],
'label' => $pipeline['label'],
];
}
return $pipelines;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchMeetingOutcomeFieldOptions(Field $field): array
{
return $field->getCrmProviderId() === 'meetingOutcome'
? $this->fetchMeetingOutcomeTypes()
: $this->fetchCallActivityTypes();
}
public function fetchMeetingOutcomeTypes(): array
{
return $this->extractMeetingTypeOptions(
'[URL_WITH_CREDENTIALS] Response $response */
$response = $this->getInstance()
->getClient()
->request('GET', $endpoint);
/**
* @var array<array{
* value: string,
* label: string,
* displayOrder: int
* }> $optionData
*/
$optionData = $response->toArray()['options'] ?? [];
$options = [];
foreach ($optionData as $item) {
$options[] = [
'id' => $item['value'],
'value' => $item['value'],
'label' => $item['label'],
'display_order' => $item['displayOrder'],
];
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchDispositionFieldOptions(): array
{
$options = [];
$dispositions = $this->fetchCallDispositions();
foreach ($dispositions as $disposition) {
if ($disposition['deleted'] !== false) {
continue;
}
$option['value'] = $disposition['id'];
$option['id'] = $disposition['id'];
$option['label'] = $disposition['label'];
$options[] = $option;
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityFieldOptions(Field $field): array
{
if ($field->isStageField()) {
return $this->fetchOpportunityPipelineStages();
}
if ($field->isPipelineField()) {
return $this->fetchOpportunityPipelines();
}
return $this->fetchPropertyOptions('deals', $field->getCrmProviderId());
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function makeRequest(string $endpoint, $method = 'GET', $payload = [], ?string $queryString = null)
{
$endpoint = self::BASE_URL . $endpoint;
if ($method === 'GET') {
$response = $this->getInstance()->getClient()?->request(
method: $method,
endpoint: $endpoint,
query_string: $queryString
);
} else {
$response = $this->getInstance()->getClient()->request($method, $endpoint, [
'json' => ($payload),
]);
}
$max = $response->getHeaderLine('X-HubSpot-RateLimit-Max'); // "110"
$remaining = $response->getHeaderLine('X-HubSpot-RateLimit-Remaining'); // "109"
$interval = $response->getHeaderLine('X-HubSpot-RateLimit-Interval-Milliseconds'); // "10000"
$body = json_decode((string) $response->getBody(), true);
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$max ' . PHP_EOL . print_r($max, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$remaining ' . PHP_EOL . print_r($remaining, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$interval ' . PHP_EOL . print_r($interval, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$body ' . PHP_EOL . print_r($body, true));
return $response;
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function createMeeting(array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings';
return $this->makeRequest($endpoint, 'POST', $payload);
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function updateMeeting(string $meetingId, array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings/' . $meetingId;
return $this->makeRequest($endpoint, 'PATCH', $payload);
}
/**
* @throws \Exception
*/
public function createNote(
string $body,
string $ownerId,
int $timestamp,
string $objectId,
NoteObject $noteObject
): ?string {
try {
$noteInput = new SimplePublicObjectInput([
'properties' => [
'hs_note_body' => $body,
'hubspot_owner_id' => $ownerId,
'hs_timestamp' => $timestamp,
],
]);
// Create note
$note = $this->getNewInstance()->crm()->objects()->basicApi()->create('note', $noteInput);
$this->getNewInstance()->crm()->objects()->associationsApi()->create(
'note',
$note->getId(),
$this->getNoteObject($noteObject),
$objectId,
$this->getNoteAssociationType($noteObject),
);
return $note->getId();
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to create note', [
'objectId' => $objectId,
'noteObject' => $noteObject->getObjectType(),
'reason' => $e->getMessage(),
]);
\Sentry::captureException($e);
}
return null;
}
public function updateEngagement(string $objectId, array $engagement, array $metadata): void
{
$this->getInstance()->engagements()->update($objectId, $engagement, $metadata);
}
public function getEngagementData(string $engagementId): array
{
$engagement = $this->getInstance()->engagements()->get($engagementId);
return $engagement->toArray();
}
public function createEngagement(array $engagement, array $associations, array $metadata): Response
{
return $this->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
}
public function isUnauthorizedException(\Exception $e): bool
{
// Check for specific HubSpot API exception types first
if ($e instanceof BadRequest) {
// BadRequest can contain 401 status codes
return $e->getCode() === 401;
}
// Check for HTTP client exceptions with status codes
if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
$response = $e->getResponse();
if ($response !== null) {
return $response->getStatusCode() === 401;
}
}
// Check for Guzzle HTTP exceptions
if ($e instanceof \GuzzleHttp\Exception\ClientException) {
return $e->getCode() === 401;
}
// Fallback to string matching as last resort, but be more specific
$message = strtolower($e->getMessage());
return str_contains($message, '401 unauthorized') ||
str_contains($message, 'http 401') ||
str_contains($message, 'status code 401') ||
(preg_match('/\b401\b/', $message) && str_contains($message, 'unauthorized'));
}
/**
* Validates and refreshes the access token if needed before API requests.
* This ensures long-running processes don't fail due to token expiration.
*
* @throws SocialAccountTokenInvalidException
*/
public function ensureValidToken(): void
{
if ($this->oauthAccount === null) {
return;
}
$newToken = $this->tokenManager->ensureValidToken($this->oauthAccount);
if ($newToken !== null) {
$this->accessToken = $newToken;
}
}
public function getConfig()
{
return $this->config;
}
// returns only active (archived=false)
public function getOwners(): array
{
return $this->getNewInstance()->crm()->owners()->getAll();
}
/**
* @param bool $archived
*
* @return array<Owner>|[]
*/
public function getOwnersArchived(bool $archived = true): array
{
$endpoint = '/crm/v3/owners';
$queryParams = [
'archived' => $archived ? 'true' : 'false',
];
$queryString = http_build_query($queryParams);
$owners = [];
try {
$response = $this->makeRequest(endpoint: $endpoint, queryString: $queryString);
$responseData = $response?->toArray();
foreach ($responseData['results'] as $result) {
try {
$owners[] = Owner::create($result);
} catch (Throwable $e) {
$this->log->error('[HubSpot] Failed to process owner data', [
'result' => $result,
'error' => $e->getMessage(),
]);
continue;
}
}
} catch (Throwable $e) {
$this->log->error('HubSpot] Failed to fetch owners', [
'archived' => $archived,
'error' => $e->getMessage(),
]);
return [];
}
return $owners;
}
public function getMeeting(string $engagementId): ObjectWithAssociations
{
return $this->getNewInstance()->crm()->objects()->basicApi()
->getById('meeting', $engagementId, null, 'contact,company,deal');
}
public function deleteEngagement(string $engagementId): void
{
$this->getInstance()->engagements()->delete((int) $engagementId);
}
public function getAssociationsData(array $ids, string $fromObject, string $toObject): array
{
$associationData = [];
$idChunks = array_chunk($ids, self::ASSOCIATIONS_BATCH_SIZE_LIMIT);
foreach ($idChunks as $idChunk) {
try {
$batchInput = new \HubSpot\Client\Crm\Associations\Model\BatchInputPublicObjectId();
$batchInput->setInputs(array_map(function ($id) {
$publicObjectId = new \HubSpot\Client\Crm\Associations\Model\PublicObjectId();
$publicObjectId->setId($id);
return $publicObjectId;
}, $idChunk));
$associatedObjectsData = $this
->getNewInstance()
->crm()
->associations()
->batchApi()
->read($fromObject, $toObject, $batchInput);
if ($associatedObjectsData instanceof \HubSpot\Client\Crm\Associations\Model\BatchResponsePublicAssociationMulti) {
foreach ($associatedObjectsData->getResults() as $association) {
$from = $association->getFrom()->getId();
$toAssociations = $association->getTo();
if (! empty($toAssociations)) {
$associationData[$from] = array_map(function ($item) {
return $item->getId();
}, $toAssociations);
}
}
}
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to fetch associations', [
'from_object' => $fromObject,
'to_object' => $toObject,
'reason' => $e->getMessage(),
]);
}
}
return $associationData;
}
/**
* @throws \Exception
*/
private function getNoteAssociationType(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'note_to_deal',
NoteObject::Lead, NoteObject::Contact => 'note_to_contact', // or 'note_to_lead' if your portal supports it
NoteObject::Account => 'note_to_company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
/**
* @throws \Exception
*/
private function getNoteObject(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'deal',
NoteObject::Lead, NoteObject::Contact => 'contact',
NoteObject::Account => 'company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
public function addAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/create";
return $this->makeRequest($endpoint, 'POST', $payload);
}
public function removeAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/archive";
return $this->makeRequest($endpoint, 'POST', $payload);
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – HS_local [jiminny@localhost]
|
NULL
|
4571
|
|
4572
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Execute
Explain Plan
Browse Query History
View Parameters
Open Query Execution Settings…
In-Editor Results
Tx: Auto
Cancel Running Statements
Playground
jiminny
Sync Changes
Hide This Notification
Code changed:
Hide
6
1
6
Previous Highlighted Error
Next Highlighted Error
# [PASSWORD_DOTS] HS [PASSWORD_DOTS]
select * from teams where id = 2; # 2
select * from features; # 2
select * from team_features where team_id = 2; # 2
select * from crm_configurations where id = 2; # 2
select * from users where team_id = 2; #
select * from playbooks where team_id = 2; # event 38
select * from playbook_categories where playbook_id = 38; #
SELECT * FROM activities WHERE crm_configuration_id = 2 and crm_provider_id is not null order by id desc;
[URL_WITH_CREDENTIALS] CrmFieldOption array{id:string, label:string, value?:string}
*/
class Client extends BaseClient implements HubspotClientInterface
{
public const string MIN_API_VERSION = '2';
public const string BASE_URL = '[URL_WITH_CREDENTIALS] T
* @param callable(): T $apiCall
* @return T
*
* @throws RateLimitException
*/
private function executeRequest(callable $apiCall)
{
if (! $this->rateLimiter->canMakeRequest($this->config)) {
$retryAfter = $this->rateLimiter->requestAvailableIn($this->config);
$this->log->warning('[Hubspot] Rate limit exceeded, deferring request', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
]);
throw new RateLimitException(
'Hubspot rate limit reached for configuration ' . $this->config->getId(),
$retryAfter,
);
}
$this->rateLimiter->incrementRequestCount($this->config);
try {
return $apiCall();
} catch (Throwable $e) {
if ($this->isHubspotRateLimit($e)) {
$retryAfter = $this->parseRetryAfter($e);
$this->log->warning('[Hubspot] Received 429 from API', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
'reason' => $e->getMessage(),
]);
throw new RateLimitException('Hubspot returned 429', $retryAfter, $e);
}
throw $e;
}
}
public function isHubspotRateLimit(Throwable $e): bool
{
return method_exists($e, 'getCode') && (int) $e->getCode() === 429;
}
public function parseRetryAfter(Throwable $e): int
{
\Illuminate\Support\Facades\Log::channel('custom_channel')->info("parseRetryAfter");
if (method_exists($e, 'getResponseHeaders')) {
$headers = $e->getResponseHeaders() ?: [];
$value = $headers['Retry-After'] ?? $headers['retry-after'] ?? null;
if (is_array($value)) {
$value = $value[0] ?? null;
}
if (is_numeric($value)) {
return (int) $value;
}
}
$current = $e;
while ($current !== null) {
if (method_exists($current, 'getResponse')) {
$response = $current->getResponse();
if ($response !== null) {
$headers = $response->getHeaders();
}
}
$current = $current->getPrevious();
}
$this->log->info('[Hubspot] DEBUG Getting headers', [
'headers' => $headers ?? [],
]);
return 10;
}
public function getMinimumApiVersion(): string
{
return self::MIN_API_VERSION;
}
public function getInstance(): Factory
{
return new Factory([
'key' => $this->accessToken,
'oauth2' => true,
'base_url' => $this->baseUrl,
]);
}
public function getNewInstance(): Discovery
{
return \HubSpot\Factory::createWithAccessToken($this->accessToken);
}
/**
* Secondly and daily limits for Hubspot API
*
* Product Tier: Free & Starter | Professional & Enterprise | API add-on (any tier)
* Burst: 100/10 seconds | 150/10 seconds | 200/10 seconds
* Daily: 250,000 | 500,000 | 1,000,000
*
* Official documentation states: The search endpoints are rate limited to five requests per second.
* Since with 5 RPS were still hitting secondly rate limits we lowered it to 4
*/
public function getPaginatedData(array $payload, string $type, int $offset = 0): array
{
$total = 0;
$lastId = null;
$rows = [];
foreach ($this->getPaginatedDataGenerator($payload, $type, $offset, $total, $lastId) as $row) {
$rows[] = $row;
}
return ['results' => $rows, 'total' => $total, 'last_record' => $lastId];
}
/**
* @throws HubspotException
* @throws SocialAccountTokenInvalidException
* @throws BadRequest
*/
public function getPaginatedDataGenerator(
array $payload,
string $type,
int $offset = 0,
int &$total = 0,
?string &$lastRecordId = null
): \Generator {
return $this->paginationService->getPaginatedDataGenerator(
$this,
$payload,
$type,
$offset,
$total,
$lastRecordId
);
}
/**
* @throws DealApiException
* @throws CrmException
*/
public function getOpportunityById(string $crmId, array $fields): array
{
try {
// $deal = $this->executeRequest(fn () => $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$deal = $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$crmId,
implode(',', $fields),
'companies,contacts'
);
} catch (DealApiException $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $deal instanceof DealWithAssociations) {
throw new CrmException('Deal not found');
}
return [
'id' => $deal->getId(),
'properties' => $deal->getProperties(),
'associations' => $deal->getAssociations(),
];
}
/**
* Generic batch read method for HubSpot objects
*
* @param string $objectType The object type ('deals', 'companies', 'contacts')
* @param array<string> $crmIds Array of HubSpot object IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with object data
*/
private function batchReadObjects(string $objectType, array $crmIds, array $fields): array
{
if (empty($crmIds)) {
return [];
}
$this->validateBatchSize($objectType, $crmIds);
$this->ensureValidToken();
try {
$batchConfig = $this->createBatchConfiguration($objectType);
$batchReadRequest = $this->prepareBatchRequest($batchConfig, $crmIds, $fields);
$response = $batchConfig['api']->read($batchReadRequest);
$this->validateApiResponse($response, $objectType);
$results = $this->processApiResults($response);
$this->logBatchResults($objectType, $crmIds, $results);
return $results;
} catch (\Throwable $e) {
$this->handleBatchError($e, $objectType, $crmIds);
}
}
private function validateBatchSize(string $objectType, array $crmIds): void
{
if (count($crmIds) > 100) {
throw new \InvalidArgumentException("Batch size cannot exceed 100 {$objectType}");
}
}
private function createBatchConfiguration(string $objectType): array
{
$configurations = [
'deals' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Deals\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->deals()->batchApi(),
],
'companies' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Companies\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Companies\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->companies()->batchApi(),
],
'contacts' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Contacts\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->contacts()->batchApi(),
],
];
if (! isset($configurations[$objectType])) {
throw new \InvalidArgumentException("Unsupported object type: {$objectType}");
}
return $configurations[$objectType];
}
private function prepareBatchRequest(array $batchConfig, array $crmIds, array $fields): object
{
$batchReadRequest = $batchConfig['batchReadRequest'];
$inputClass = $batchConfig['inputClass'];
$inputs = array_map(function ($crmId) use ($inputClass) {
$input = new $inputClass();
$input->setId($crmId);
return $input;
}, $crmIds);
$batchReadRequest->setInputs($inputs);
$batchReadRequest->setProperties($fields);
return $batchReadRequest;
}
private function validateApiResponse($response, string $objectType): void
{
if (! $response) {
throw new CrmException("HubSpot API returned null response for {$objectType} batch read");
}
}
private function processApiResults($response): array
{
$results = [];
$responseResults = $response->getResults();
if ($responseResults) {
foreach ($responseResults as $object) {
if ($object && $object->getId()) {
$results[$object->getId()] = [
'id' => $object->getId(),
'properties' => $object->getProperties() ?: [],
];
}
}
}
return $results;
}
private function logBatchResults(string $objectType, array $crmIds, array $results): void
{
$this->log->info("[HubSpot] Batch fetched {$objectType}", [
'requested_count' => count($crmIds),
'returned_count' => count($results),
'crm_ids' => $crmIds,
]);
}
private function handleBatchError(\Throwable $e, string $objectType, array $crmIds): void
{
$errorMessage = $e->getMessage() ?: 'Unknown error';
$errorTrace = $e->getTraceAsString() ?: 'No trace available';
$this->log->error("[HubSpot] Failed to batch fetch {$objectType}", [
'crm_ids' => $crmIds,
'error' => $errorMessage,
'trace' => $errorTrace,
]);
throw new CrmException("Failed to batch fetch {$objectType}: " . $errorMessage);
}
/**
* Batch read multiple opportunities by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot deal IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with opportunity data
*/
public function getOpportunitiesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('deals', $crmIds, $fields);
}
/**
* Batch read multiple companies by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot company IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with company data
*/
public function getCompaniesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('companies', $crmIds, $fields);
}
/**
* Batch read multiple contacts by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot contact IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with contact data
*/
public function getContactsByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('contacts', $crmIds, $fields);
}
/**
* @throws CompanyApiException
* @throws CrmException
*/
public function getAccountById(string $crmId, array $fields): array
{
try {
$company = $this->getNewInstance()->crm()->companies()->basicApi()->getById(
$crmId,
implode(',', $fields),
);
} catch (CompanyApiException $e) {
$this->log->info('[Hubspot] Failed to fetch account', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $company instanceof CompaniesWithAssociations) {
throw new CrmException('Account not found');
}
return [
'id' => $company->getId(),
'properties' => $company->getProperties(),
];
}
/**
* @throws ContactApiException
* @throws CrmException
*/
public function getContactById(string $crmId, array $fields): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$crmId,
implode(',', $fields)
);
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $contact instanceof ContactsWithAssociations) {
throw new CrmException('Contact not found');
}
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
}
/**
* This is email search request that Hubspot offers as GET (more generous quota)
*/
public function getContactByEmail(string $email, array $fields = []): array
{
try {
$contact = $this->getNewInstance()->crm()->contacts()->basicApi()->getById(
$email,
implode(',', $fields),
null,
false,
'email'
);
return [
'id' => $contact->getId(),
'properties' => $contact->getProperties(),
];
} catch (ContactApiException $e) {
$this->log->info('[Hubspot] Failed to fetch contact', [
'email' => $email,
'reason' => $e->getMessage(),
]);
return [];
}
}
/**
* @throws CrmException
*/
public function fetchProperty(string $objectType, string $propertyId): Property
{
$result = $this->getNewInstance()->crm()->properties()->coreApi()->getByName($objectType, $propertyId);
if (! $result instanceof Property) {
$this->log->error('[Hubspot] Failed to fetch property', [
'object_type' => $objectType,
'property_id' => $propertyId,
'reason' => $result->getMessage(),
]);
throw new CrmException('Failed to fetch property');
}
return $result;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchPropertyOptions(string $objectType, string $propertyId): array
{
/** @var array<CrmFieldOption> */
return $this->fetchProperty($objectType, $propertyId)->getOptions();
}
/**
* @return array<array{id:string, label:string, deleted:bool}>
*/
public function fetchCallDispositions(): array
{
/** @var Response $response */
$response = $this->getInstance()->engagements()->getCallDispositions();
/**
* @var array<array{
* id:string,
* label:string,
* deleted: bool
* }>
*/
return $response->toArray();
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityPipelineStages(): array
{
$stages = [];
$apiResponse = $this->getNewInstance()->crm()->pipelines()->pipelinesApi()->getAll('deals');
if ($apiResponse instanceof Error) {
$this->log->error('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $apiResponse->getMessage(),
]);
return [];
}
foreach ($apiResponse->getResults() as $pipeline) {
$pipelineStages = array_map(
static function (PipelineStage $stage) {
return [
'id' => $stage->getId(),
'label' => $stage->getLabel(),
];
},
$pipeline->getStages()
);
$stages = array_merge($stages, $pipelineStages);
}
return $stages;
}
public function fetchOpportunityPipelines(): array
{
$pipelines = [];
try {
$apiResponse = $this->makeRequest('/crm/v3/pipelines/deals');
} catch (\Exception $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity pipelines', [
'reason' => $e->getMessage(),
]);
return [];
}
$response = $apiResponse->toArray();
foreach ($response['results'] as $pipeline) {
$pipelines[] = [
'id' => $pipeline['id'],
'label' => $pipeline['label'],
];
}
return $pipelines;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchMeetingOutcomeFieldOptions(Field $field): array
{
return $field->getCrmProviderId() === 'meetingOutcome'
? $this->fetchMeetingOutcomeTypes()
: $this->fetchCallActivityTypes();
}
public function fetchMeetingOutcomeTypes(): array
{
return $this->extractMeetingTypeOptions(
'[URL_WITH_CREDENTIALS] Response $response */
$response = $this->getInstance()
->getClient()
->request('GET', $endpoint);
/**
* @var array<array{
* value: string,
* label: string,
* displayOrder: int
* }> $optionData
*/
$optionData = $response->toArray()['options'] ?? [];
$options = [];
foreach ($optionData as $item) {
$options[] = [
'id' => $item['value'],
'value' => $item['value'],
'label' => $item['label'],
'display_order' => $item['displayOrder'],
];
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchDispositionFieldOptions(): array
{
$options = [];
$dispositions = $this->fetchCallDispositions();
foreach ($dispositions as $disposition) {
if ($disposition['deleted'] !== false) {
continue;
}
$option['value'] = $disposition['id'];
$option['id'] = $disposition['id'];
$option['label'] = $disposition['label'];
$options[] = $option;
}
return $options;
}
/**
* @return array<CrmFieldOption>
*/
public function fetchOpportunityFieldOptions(Field $field): array
{
if ($field->isStageField()) {
return $this->fetchOpportunityPipelineStages();
}
if ($field->isPipelineField()) {
return $this->fetchOpportunityPipelines();
}
return $this->fetchPropertyOptions('deals', $field->getCrmProviderId());
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function makeRequest(string $endpoint, $method = 'GET', $payload = [], ?string $queryString = null)
{
$endpoint = self::BASE_URL . $endpoint;
if ($method === 'GET') {
$response = $this->getInstance()->getClient()?->request(
method: $method,
endpoint: $endpoint,
query_string: $queryString
);
} else {
$response = $this->getInstance()->getClient()->request($method, $endpoint, [
'json' => ($payload),
]);
}
$max = $response->getHeaderLine('X-HubSpot-RateLimit-Max'); // "110"
$remaining = $response->getHeaderLine('X-HubSpot-RateLimit-Remaining'); // "109"
$interval = $response->getHeaderLine('X-HubSpot-RateLimit-Interval-Milliseconds'); // "10000"
$body = json_decode((string) $response->getBody(), true);
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$max ' . PHP_EOL . print_r($max, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$remaining ' . PHP_EOL . print_r($remaining, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$interval ' . PHP_EOL . print_r($interval, true));
\Illuminate\Support\Facades\Log::channel('custom_channel')->info('$body ' . PHP_EOL . print_r($body, true));
return $response;
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function createMeeting(array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings';
return $this->makeRequest($endpoint, 'POST', $payload);
}
/**
* @throws BadRequest
* @throws HubspotException
*/
public function updateMeeting(string $meetingId, array $payload): Response
{
$endpoint = '/crm/v3/objects/meetings/' . $meetingId;
return $this->makeRequest($endpoint, 'PATCH', $payload);
}
/**
* @throws \Exception
*/
public function createNote(
string $body,
string $ownerId,
int $timestamp,
string $objectId,
NoteObject $noteObject
): ?string {
try {
$noteInput = new SimplePublicObjectInput([
'properties' => [
'hs_note_body' => $body,
'hubspot_owner_id' => $ownerId,
'hs_timestamp' => $timestamp,
],
]);
// Create note
$note = $this->getNewInstance()->crm()->objects()->basicApi()->create('note', $noteInput);
$this->getNewInstance()->crm()->objects()->associationsApi()->create(
'note',
$note->getId(),
$this->getNoteObject($noteObject),
$objectId,
$this->getNoteAssociationType($noteObject),
);
return $note->getId();
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to create note', [
'objectId' => $objectId,
'noteObject' => $noteObject->getObjectType(),
'reason' => $e->getMessage(),
]);
\Sentry::captureException($e);
}
return null;
}
public function updateEngagement(string $objectId, array $engagement, array $metadata): void
{
$this->getInstance()->engagements()->update($objectId, $engagement, $metadata);
}
public function getEngagementData(string $engagementId): array
{
$engagement = $this->getInstance()->engagements()->get($engagementId);
return $engagement->toArray();
}
public function createEngagement(array $engagement, array $associations, array $metadata): Response
{
return $this->getInstance()
->engagements()
->create($engagement, $associations, $metadata);
}
public function isUnauthorizedException(\Exception $e): bool
{
// Check for specific HubSpot API exception types first
if ($e instanceof BadRequest) {
// BadRequest can contain 401 status codes
return $e->getCode() === 401;
}
// Check for HTTP client exceptions with status codes
if ($e instanceof \GuzzleHttp\Exception\RequestException && $e->hasResponse()) {
$response = $e->getResponse();
if ($response !== null) {
return $response->getStatusCode() === 401;
}
}
// Check for Guzzle HTTP exceptions
if ($e instanceof \GuzzleHttp\Exception\ClientException) {
return $e->getCode() === 401;
}
// Fallback to string matching as last resort, but be more specific
$message = strtolower($e->getMessage());
return str_contains($message, '401 unauthorized') ||
str_contains($message, 'http 401') ||
str_contains($message, 'status code 401') ||
(preg_match('/\b401\b/', $message) && str_contains($message, 'unauthorized'));
}
/**
* Validates and refreshes the access token if needed before API requests.
* This ensures long-running processes don't fail due to token expiration.
*
* @throws SocialAccountTokenInvalidException
*/
public function ensureValidToken(): void
{
if ($this->oauthAccount === null) {
return;
}
$newToken = $this->tokenManager->ensureValidToken($this->oauthAccount);
if ($newToken !== null) {
$this->accessToken = $newToken;
}
}
public function getConfig()
{
return $this->config;
}
// returns only active (archived=false)
public function getOwners(): array
{
return $this->getNewInstance()->crm()->owners()->getAll();
}
/**
* @param bool $archived
*
* @return array<Owner>|[]
*/
public function getOwnersArchived(bool $archived = true): array
{
$endpoint = '/crm/v3/owners';
$queryParams = [
'archived' => $archived ? 'true' : 'false',
];
$queryString = http_build_query($queryParams);
$owners = [];
try {
$response = $this->makeRequest(endpoint: $endpoint, queryString: $queryString);
$responseData = $response?->toArray();
foreach ($responseData['results'] as $result) {
try {
$owners[] = Owner::create($result);
} catch (Throwable $e) {
$this->log->error('[HubSpot] Failed to process owner data', [
'result' => $result,
'error' => $e->getMessage(),
]);
continue;
}
}
} catch (Throwable $e) {
$this->log->error('HubSpot] Failed to fetch owners', [
'archived' => $archived,
'error' => $e->getMessage(),
]);
return [];
}
return $owners;
}
public function getMeeting(string $engagementId): ObjectWithAssociations
{
return $this->getNewInstance()->crm()->objects()->basicApi()
->getById('meeting', $engagementId, null, 'contact,company,deal');
}
public function deleteEngagement(string $engagementId): void
{
$this->getInstance()->engagements()->delete((int) $engagementId);
}
public function getAssociationsData(array $ids, string $fromObject, string $toObject): array
{
$associationData = [];
$idChunks = array_chunk($ids, self::ASSOCIATIONS_BATCH_SIZE_LIMIT);
foreach ($idChunks as $idChunk) {
try {
$batchInput = new \HubSpot\Client\Crm\Associations\Model\BatchInputPublicObjectId();
$batchInput->setInputs(array_map(function ($id) {
$publicObjectId = new \HubSpot\Client\Crm\Associations\Model\PublicObjectId();
$publicObjectId->setId($id);
return $publicObjectId;
}, $idChunk));
$associatedObjectsData = $this
->getNewInstance()
->crm()
->associations()
->batchApi()
->read($fromObject, $toObject, $batchInput);
if ($associatedObjectsData instanceof \HubSpot\Client\Crm\Associations\Model\BatchResponsePublicAssociationMulti) {
foreach ($associatedObjectsData->getResults() as $association) {
$from = $association->getFrom()->getId();
$toAssociations = $association->getTo();
if (! empty($toAssociations)) {
$associationData[$from] = array_map(function ($item) {
return $item->getId();
}, $toAssociations);
}
}
}
} catch (\Exception $e) {
$this->log->error('[Hubspot] Failed to fetch associations', [
'from_object' => $fromObject,
'to_object' => $toObject,
'reason' => $e->getMessage(),
]);
}
}
return $associationData;
}
/**
* @throws \Exception
*/
private function getNoteAssociationType(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'note_to_deal',
NoteObject::Lead, NoteObject::Contact => 'note_to_contact', // or 'note_to_lead' if your portal supports it
NoteObject::Account => 'note_to_company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
/**
* @throws \Exception
*/
private function getNoteObject(NoteObject $noteObject): string
{
return match($noteObject) {
NoteObject::Opportunity => 'deal',
NoteObject::Lead, NoteObject::Contact => 'contact',
NoteObject::Account => 'company',
NoteObject::Call, NoteObject::Event => throw new \Exception('Not supported'),
};
}
public function addAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/create";
return $this->makeRequest($endpoint, 'POST', $payload);
}
public function removeAssociations(string $objectType, string $associationType, array $payload): Response
{
$endpoint = "/crm/v4/associations/$objectType/$associationType/batch/archive";
return $this->makeRequest($endpoint, 'POST', $payload);
}
}
Project
Project
New File or Directory…
Expand Selected
Collapse All
Options
Hide...
|
PhpStorm
|
faVsco.js – HS_local [jiminny@localhost]
|
NULL
|
4572
|
|
4573
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
168
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:08:22] local.NOTICE: Monitoring start {"correlation_id":"d080a9c0-0eca-4cb1-a3a8-0144debc5512","trace_id":"b6fced05-bd66-448a-b6ed-1a158a4335f4"}
[2026-05-07 14:08:23] local.NOTICE: Monitoring end {"correlation_id":"d080a9c0-0eca-4cb1-a3a8-0144debc5512","trace_id":"b6fced05-bd66-448a-b6ed-1a158a4335f4"}
[2026-05-07 14:08:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"fbe17093-d88a-4085-a766-e12ab1b648a4","trace_id":"06b1c475-70e0-42ec-9805-d78f59c0c5d1"}
[2026-05-07 14:08:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"fbe17093-d88a-4085-a766-e12ab1b648a4","trace_id":"06b1c475-70e0-42ec-9805-d78f59c0c5d1"}
[2026-05-07 14:08:34] local.INFO: [SocialAccountService] Fetching token {"socialAccountId":1499,"provider":"hubspot"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [SocialAccountService] Token retrieved {"socialAccountId":1499,"provider":"hubspot"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [EncryptedTokenManager] Generating access token. {"mode":"legacy"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [CrmOwnerResolver] Integration owner matched as CRM Owner {"crm_provider":"hubspot","crm_owner":148,"team_id":2} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:35] local.INFO: [Hubspot] Received 429 from API {"team_id":2,"config_id":2,"retry_after":10,"reason":"Client error: `POST [URL_WITH_CREDENTIALS] CrmFieldOption array{id:string, label:string, value?:string}
*/
class Client extends BaseClient implements HubspotClientInterface
{
public const string MIN_API_VERSION = '2';
public const string BASE_URL = '[URL_WITH_CREDENTIALS] T
* @param callable(): T $apiCall
* @return T
*
* @throws RateLimitException
*/
private function executeRequest(callable $apiCall)
{
if (! $this->rateLimiter->canMakeRequest($this->config)) {
$retryAfter = $this->rateLimiter->requestAvailableIn($this->config);
$this->log->warning('[Hubspot] Rate limit exceeded, deferring request', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
]);
throw new RateLimitException(
'Hubspot rate limit reached for configuration ' . $this->config->getId(),
$retryAfter,
);
}
$this->rateLimiter->incrementRequestCount($this->config);
try {
return $apiCall();
} catch (Throwable $e) {
if ($this->isHubspotRateLimit($e)) {
$retryAfter = $this->parseRetryAfter($e);
$this->log->warning('[Hubspot] Received 429 from API', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
'reason' => $e->getMessage(),
]);
throw new RateLimitException('Hubspot returned 429', $retryAfter, $e);
}
throw $e;
}
}
public function isHubspotRateLimit(Throwable $e): bool
{
return method_exists($e, 'getCode') && (int) $e->getCode() === 429;
}
public function parseRetryAfter(Throwable $e): int
{
\Illuminate\Support\Facades\Log::channel('custom_channel')->info("parseRetryAfter");
if (method_exists($e, 'getResponseHeaders')) {
$headers = $e->getResponseHeaders() ?: [];
$value = $headers['Retry-After'] ?? $headers['retry-after'] ?? null;
if (is_array($value)) {
$value = $value[0] ?? null;
}
if (is_numeric($value)) {
return (int) $value;
}
}
$current = $e;
while ($current !== null) {
if (method_exists($current, 'getResponse')) {
$response = $current->getResponse();
if ($response !== null) {
$headers = $response->getHeaders();
}
}
$current = $current->getPrevious();
}
$this->log->info('[Hubspot] DEBUG Getting headers', [
'headers' => $headers ?? [],
]);
return 10;
}
public function getMinimumApiVersion(): string
{
return self::MIN_API_VERSION;
}
public function getInstance(): Factory
{
return new Factory([
'key' => $this->accessToken,
'oauth2' => true,
'base_url' => $this->baseUrl,
]);
}
public function getNewInstance(): Discovery
{
return \HubSpot\Factory::createWithAccessToken($this->accessToken);
}
/**
* Secondly and daily limits for Hubspot API
*
* Product Tier: Free & Starter | Professional & Enterprise | API add-on (any tier)
* Burst: 100/10 seconds | 150/10 seconds | 200/10 seconds
* Daily: 250,000 | 500,000 | 1,000,000
*
* Official documentation states: The search endpoints are rate limited to five requests per second.
* Since with 5 RPS were still hitting secondly rate limits we lowered it to 4
*/
public function getPaginatedData(array $payload, string $type, int $offset = 0): array
{
$total = 0;
$lastId = null;
$rows = [];
foreach ($this->getPaginatedDataGenerator($payload, $type, $offset, $total, $lastId) as $row) {
$rows[] = $row;
}
return ['results' => $rows, 'total' => $total, 'last_record' => $lastId];
}
/**
* @throws HubspotException
* @throws SocialAccountTokenInvalidException
* @throws BadRequest
*/
public function getPaginatedDataGenerator(
array $payload,
string $type,
int $offset = 0,
int &$total = 0,
?string &$lastRecordId = null
): \Generator {
return $this->paginationService->getPaginatedDataGenerator(
$this,
$payload,
$type,
$offset,
$total,
$lastRecordId
);
}
/**
* @throws DealApiException
* @throws CrmException
*/
public function getOpportunityById(string $crmId, array $fields): array
{
try {
// $deal = $this->executeRequest(fn () => $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$deal = $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$crmId,
implode(',', $fields),
'companies,contacts'
);
} catch (DealApiException $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $deal instanceof DealWithAssociations) {
throw new CrmException('Deal not found');
}
return [
'id' => $deal->getId(),
'properties' => $deal->getProperties(),
'associations' => $deal->getAssociations(),
];
}
/**
* Generic batch read method for HubSpot objects
*
* @param string $objectType The object type ('deals', 'companies', 'contacts')
* @param array<string> $crmIds Array of HubSpot object IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with object data
*/
private function batchReadObjects(string $objectType, array $crmIds, array $fields): array
{
if (empty($crmIds)) {
return [];
}
$this->validateBatchSize($objectType, $crmIds);
$this->ensureValidToken();
try {
$batchConfig = $this->createBatchConfiguration($objectType);
$batchReadRequest = $this->prepareBatchRequest($batchConfig, $crmIds, $fields);
$response = $batchConfig['api']->read($batchReadRequest);
$this->validateApiResponse($response, $objectType);
$results = $this->processApiResults($response);
$this->logBatchResults($objectType, $crmIds, $results);
return $results;
} catch (\Throwable $e) {
$this->handleBatchError($e, $objectType, $crmIds);
}
}
private function validateBatchSize(string $objectType, array $crmIds): void
{
if (count($crmIds) > 100) {
throw new \InvalidArgumentException("Batch size cannot exceed 100 {$objectType}");
}
}
private function createBatchConfiguration(string $objectType): array
{
$configurations = [
'deals' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Deals\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->deals()->batchApi(),
],
'companies' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Companies\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Companies\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->companies()->batchApi(),
],
'contacts' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Contacts\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->contacts()->batchApi(),
],
];
if (! isset($configurations[$objectType])) {
throw new \InvalidArgumentException("Unsupported object type: {$objectType}");
}
return $configurations[$objectType];
}
private function prepareBatchRequest(array $batchConfig, array $crmIds, array $fields): object
{
$batchReadRequest = $batchConfig['batchReadRequest'];
$inputClass = $batchConfig['inputClass'];
$inputs = array_map(function ($crmId) use ($inputClass) {
$input = new $inputClass();
$input->setId($crmId);
return $input;
}, $crmIds);
$batchReadRequest->setInputs($inputs);
$batchReadRequest->setProperties($fields);
return $batchReadRequest;
}
private function validateApiResponse($response, string $objectType): void
{
if (! $response) {
throw new CrmException("HubSpot API returned null response for {$objectType} batch read");
}
}
private function processApiResults($response): array
{
$results = [];
$responseResults = $response->getResults();
if ($responseResults) {
foreach ($responseResults as $object) {
if ($object && $object->getId()) {
$results[$object->getId()] = [
'id' => $object->getId(),
'properties' => $object->getProperties() ?: [],
];
}
}
}
return $results;
}
private function logBatchResults(string $objectType, array $crmIds, array $results): void
{
$this->log->info("[HubSpot] Batch fetched {$objectType}", [
'requested_count' => count($crmIds),
'returned_count' => count($results),
'crm_ids' => $crmIds,
]);
}
private function handleBatchError(\Throwable $e, string $objectType, array $crmIds): void
{
$errorMessage = $e->getMessage() ?: 'Unknown error';
$errorTrace = $e->getTraceAsString() ?: 'No trace available';
$this->log->error("[HubSpot] Failed to batch fetch {$objectType}", [
'crm_ids' => $crmIds,
'error' => $errorMessage,
'trace' => $errorTrace,
]);
throw new CrmException("Failed to batch fetch {$objectType}: " . $errorMessage);
}
/**
* Batch read multiple opportunities by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot deal IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with opportunity data
*/
public function getOpportunitiesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('deals', $crmIds, $fields);
}
/**
* Batch read multiple companies by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot company IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with company data
*/
public function getCompaniesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('companies', $crmIds, $fields);
}
/**
* Batch read multiple contacts by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot contact IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with contact data
*/
public function getContactsByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('contacts', $crmIds, $fields);
}
/**
* @throws CompanyApiException
* @throws CrmException
*/
public function getAccountById(string $crmId, array $fields): array
{
try {
$company = $this->getNewInstance()->crm()->companies()->basicApi()->getById(
$crmId,
implode(',', $fields),
);
} catch (CompanyApiException $e) {
$this->log...
|
PhpStorm
|
faVsco.js – laravel.log
|
NULL
|
4573
|
|
4574
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
168
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:08:22] local.NOTICE: Monitoring start {"correlation_id":"d080a9c0-0eca-4cb1-a3a8-0144debc5512","trace_id":"b6fced05-bd66-448a-b6ed-1a158a4335f4"}
[2026-05-07 14:08:23] local.NOTICE: Monitoring end {"correlation_id":"d080a9c0-0eca-4cb1-a3a8-0144debc5512","trace_id":"b6fced05-bd66-448a-b6ed-1a158a4335f4"}
[2026-05-07 14:08:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"fbe17093-d88a-4085-a766-e12ab1b648a4","trace_id":"06b1c475-70e0-42ec-9805-d78f59c0c5d1"}
[2026-05-07 14:08:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"fbe17093-d88a-4085-a766-e12ab1b648a4","trace_id":"06b1c475-70e0-42ec-9805-d78f59c0c5d1"}
[2026-05-07 14:08:34] local.INFO: [SocialAccountService] Fetching token {"socialAccountId":1499,"provider":"hubspot"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [SocialAccountService] Token retrieved {"socialAccountId":1499,"provider":"hubspot"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [EncryptedTokenManager] Generating access token. {"mode":"legacy"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [CrmOwnerResolver] Integration owner matched as CRM Owner {"crm_provider":"hubspot","crm_owner":148,"team_id":2} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:35] local.INFO: [Hubspot] Received 429 from API {"team_id":2,"config_id":2,"retry_after":10,"reason":"Client error: `POST [URL_WITH_CREDENTIALS] CrmFieldOption array{id:string, label:string, value?:string}
*/
class Client extends BaseClient implements HubspotClientInterface
{
public const string MIN_API_VERSION = '2';
public const string BASE_URL = '[URL_WITH_CREDENTIALS] T
* @param callable(): T $apiCall
* @return T
*
* @throws RateLimitException
*/
private function executeRequest(callable $apiCall)
{
if (! $this->rateLimiter->canMakeRequest($this->config)) {
$retryAfter = $this->rateLimiter->requestAvailableIn($this->config);
$this->log->warning('[Hubspot] Rate limit exceeded, deferring request', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
]);
throw new RateLimitException(
'Hubspot rate limit reached for configuration ' . $this->config->getId(),
$retryAfter,
);
}
$this->rateLimiter->incrementRequestCount($this->config);
try {
return $apiCall();
} catch (Throwable $e) {
if ($this->isHubspotRateLimit($e)) {
$retryAfter = $this->parseRetryAfter($e);
$this->log->warning('[Hubspot] Received 429 from API', [
'team_id' => $this->config->team_id,
'config_id' => $this->config->getId(),
'retry_after' => $retryAfter,
'reason' => $e->getMessage(),
]);
throw new RateLimitException('Hubspot returned 429', $retryAfter, $e);
}
throw $e;
}
}
public function isHubspotRateLimit(Throwable $e): bool
{
return method_exists($e, 'getCode') && (int) $e->getCode() === 429;
}
public function parseRetryAfter(Throwable $e): int
{
\Illuminate\Support\Facades\Log::channel('custom_channel')->info("parseRetryAfter");
if (method_exists($e, 'getResponseHeaders')) {
$headers = $e->getResponseHeaders() ?: [];
$value = $headers['Retry-After'] ?? $headers['retry-after'] ?? null;
if (is_array($value)) {
$value = $value[0] ?? null;
}
if (is_numeric($value)) {
return (int) $value;
}
}
$current = $e;
while ($current !== null) {
if (method_exists($current, 'getResponse')) {
$response = $current->getResponse();
if ($response !== null) {
$headers = $response->getHeaders();
}
}
$current = $current->getPrevious();
}
$this->log->info('[Hubspot] DEBUG Getting headers', [
'headers' => $headers ?? [],
]);
return 10;
}
public function getMinimumApiVersion(): string
{
return self::MIN_API_VERSION;
}
public function getInstance(): Factory
{
return new Factory([
'key' => $this->accessToken,
'oauth2' => true,
'base_url' => $this->baseUrl,
]);
}
public function getNewInstance(): Discovery
{
return \HubSpot\Factory::createWithAccessToken($this->accessToken);
}
/**
* Secondly and daily limits for Hubspot API
*
* Product Tier: Free & Starter | Professional & Enterprise | API add-on (any tier)
* Burst: 100/10 seconds | 150/10 seconds | 200/10 seconds
* Daily: 250,000 | 500,000 | 1,000,000
*
* Official documentation states: The search endpoints are rate limited to five requests per second.
* Since with 5 RPS were still hitting secondly rate limits we lowered it to 4
*/
public function getPaginatedData(array $payload, string $type, int $offset = 0): array
{
$total = 0;
$lastId = null;
$rows = [];
foreach ($this->getPaginatedDataGenerator($payload, $type, $offset, $total, $lastId) as $row) {
$rows[] = $row;
}
return ['results' => $rows, 'total' => $total, 'last_record' => $lastId];
}
/**
* @throws HubspotException
* @throws SocialAccountTokenInvalidException
* @throws BadRequest
*/
public function getPaginatedDataGenerator(
array $payload,
string $type,
int $offset = 0,
int &$total = 0,
?string &$lastRecordId = null
): \Generator {
return $this->paginationService->getPaginatedDataGenerator(
$this,
$payload,
$type,
$offset,
$total,
$lastRecordId
);
}
/**
* @throws DealApiException
* @throws CrmException
*/
public function getOpportunityById(string $crmId, array $fields): array
{
try {
// $deal = $this->executeRequest(fn () => $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$deal = $this->getNewInstance()->crm()->deals()->basicApi()->getById(
$crmId,
implode(',', $fields),
'companies,contacts'
);
} catch (DealApiException $e) {
$this->log->info('[Hubspot] Failed to fetch opportunity', [
'crm_id' => $crmId,
'reason' => $e->getMessage(),
]);
throw $e;
}
if (! $deal instanceof DealWithAssociations) {
throw new CrmException('Deal not found');
}
return [
'id' => $deal->getId(),
'properties' => $deal->getProperties(),
'associations' => $deal->getAssociations(),
];
}
/**
* Generic batch read method for HubSpot objects
*
* @param string $objectType The object type ('deals', 'companies', 'contacts')
* @param array<string> $crmIds Array of HubSpot object IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with object data
*/
private function batchReadObjects(string $objectType, array $crmIds, array $fields): array
{
if (empty($crmIds)) {
return [];
}
$this->validateBatchSize($objectType, $crmIds);
$this->ensureValidToken();
try {
$batchConfig = $this->createBatchConfiguration($objectType);
$batchReadRequest = $this->prepareBatchRequest($batchConfig, $crmIds, $fields);
$response = $batchConfig['api']->read($batchReadRequest);
$this->validateApiResponse($response, $objectType);
$results = $this->processApiResults($response);
$this->logBatchResults($objectType, $crmIds, $results);
return $results;
} catch (\Throwable $e) {
$this->handleBatchError($e, $objectType, $crmIds);
}
}
private function validateBatchSize(string $objectType, array $crmIds): void
{
if (count($crmIds) > 100) {
throw new \InvalidArgumentException("Batch size cannot exceed 100 {$objectType}");
}
}
private function createBatchConfiguration(string $objectType): array
{
$configurations = [
'deals' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Deals\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Deals\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->deals()->batchApi(),
],
'companies' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Companies\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Companies\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->companies()->batchApi(),
],
'contacts' => [
'batchReadRequest' => new \HubSpot\Client\Crm\Contacts\Model\BatchReadInputSimplePublicObjectId(),
'inputClass' => \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectId::class,
'api' => $this->getNewInstance()->crm()->contacts()->batchApi(),
],
];
if (! isset($configurations[$objectType])) {
throw new \InvalidArgumentException("Unsupported object type: {$objectType}");
}
return $configurations[$objectType];
}
private function prepareBatchRequest(array $batchConfig, array $crmIds, array $fields): object
{
$batchReadRequest = $batchConfig['batchReadRequest'];
$inputClass = $batchConfig['inputClass'];
$inputs = array_map(function ($crmId) use ($inputClass) {
$input = new $inputClass();
$input->setId($crmId);
return $input;
}, $crmIds);
$batchReadRequest->setInputs($inputs);
$batchReadRequest->setProperties($fields);
return $batchReadRequest;
}
private function validateApiResponse($response, string $objectType): void
{
if (! $response) {
throw new CrmException("HubSpot API returned null response for {$objectType} batch read");
}
}
private function processApiResults($response): array
{
$results = [];
$responseResults = $response->getResults();
if ($responseResults) {
foreach ($responseResults as $object) {
if ($object && $object->getId()) {
$results[$object->getId()] = [
'id' => $object->getId(),
'properties' => $object->getProperties() ?: [],
];
}
}
}
return $results;
}
private function logBatchResults(string $objectType, array $crmIds, array $results): void
{
$this->log->info("[HubSpot] Batch fetched {$objectType}", [
'requested_count' => count($crmIds),
'returned_count' => count($results),
'crm_ids' => $crmIds,
]);
}
private function handleBatchError(\Throwable $e, string $objectType, array $crmIds): void
{
$errorMessage = $e->getMessage() ?: 'Unknown error';
$errorTrace = $e->getTraceAsString() ?: 'No trace available';
$this->log->error("[HubSpot] Failed to batch fetch {$objectType}", [
'crm_ids' => $crmIds,
'error' => $errorMessage,
'trace' => $errorTrace,
]);
throw new CrmException("Failed to batch fetch {$objectType}: " . $errorMessage);
}
/**
* Batch read multiple opportunities by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot deal IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with opportunity data
*/
public function getOpportunitiesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('deals', $crmIds, $fields);
}
/**
* Batch read multiple companies by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot company IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with company data
*/
public function getCompaniesByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('companies', $crmIds, $fields);
}
/**
* Batch read multiple contacts by their CRM IDs
*
* @param array<string> $crmIds Array of HubSpot contact IDs (max 100)
* @param array<string> $fields Array of property names to fetch
*
* @return array<string, array> Array keyed by CRM ID with contact data
*/
public function getContactsByIds(array $crmIds, array $fields): array
{
return $this->batchReadObjects('contacts', $crmIds, $fields);
}
/**
* @throws CompanyApiException
* @throws CrmException
*/
public function getAccountById(string $crmId, array $fields): array
{
try {
$company = $this->getNewInstance()->crm()->companies()->basicApi()->getById(
$crmId,
implode(',', $fields),
);
} catch (CompanyApiException $e) {
$this->log...
|
PhpStorm
|
faVsco.js – laravel.log
|
NULL
|
4574
|
|
4575
|
Project: faVsco.js, menu
master, menu
Start Listen Project: faVsco.js, menu
master, menu
Start Listening for PHP Debug Connections
AskJiminnyReportActivityServiceTest
Run 'AskJiminnyReportActivityServiceTest'
Debug 'AskJiminnyReportActivityServiceTest'
More Actions
JetBrains AI
Search Everywhere
IDE and Project Settings
Sync Changes
Hide This Notification
Code changed:
Hide
221
Previous Highlighted Error
Next Highlighted Error
[2026-05-07 14:08:22] local.NOTICE: Monitoring start {"correlation_id":"d080a9c0-0eca-4cb1-a3a8-0144debc5512","trace_id":"b6fced05-bd66-448a-b6ed-1a158a4335f4"}
[2026-05-07 14:08:23] local.NOTICE: Monitoring end {"correlation_id":"d080a9c0-0eca-4cb1-a3a8-0144debc5512","trace_id":"b6fced05-bd66-448a-b6ed-1a158a4335f4"}
[2026-05-07 14:08:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"fbe17093-d88a-4085-a766-e12ab1b648a4","trace_id":"06b1c475-70e0-42ec-9805-d78f59c0c5d1"}
[2026-05-07 14:08:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"fbe17093-d88a-4085-a766-e12ab1b648a4","trace_id":"06b1c475-70e0-42ec-9805-d78f59c0c5d1"}
[2026-05-07 14:08:34] local.INFO: [SocialAccountService] Fetching token {"socialAccountId":1499,"provider":"hubspot"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [SocialAccountService] Token retrieved {"socialAccountId":1499,"provider":"hubspot"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [EncryptedTokenManager] Generating access token. {"mode":"legacy"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:34] local.INFO: [CrmOwnerResolver] Integration owner matched as CRM Owner {"crm_provider":"hubspot","crm_owner":148,"team_id":2} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:35] local.INFO: [Hubspot] Received 429 from API {"team_id":2,"config_id":2,"retry_after":10,"reason":"Client error: `POST https://api.hubapi.com/crm/v3/objects/contact/search` resulted in a `429 Too Many Requests` response:
{\"status\":\"error\",\"message\":\"You have reached your secondly limit.\",\"errorType\":\"RATE_LIMIT\",\"correlationId\":\"019e02c4-d (truncated...)
"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:36] local.ERROR: Hubspot returned 429 {"exception":"[object] (Jiminny\\Exceptions\\RateLimitException(code: 0): Hubspot returned 429 at /home/jiminny/app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206)
[stacktrace]
#0 /home/jiminny/app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php(52): Jiminny\\Services\\Crm\\Hubspot\\Pagination\\HubspotPaginationService->executeSearchRequest(Object(Jiminny\\Services\\Crm\\Hubspot\\Client), 'https://api.hub...', Array, Object(Jiminny\\Services\\Crm\\Hubspot\\Pagination\\PaginationState))
#1 /home/jiminny/app/Services/Crm/Hubspot/Client.php(191): Jiminny\\Services\\Crm\\Hubspot\\Pagination\\HubspotPaginationService->getPaginatedDataGenerator(Object(Jiminny\\Services\\Crm\\Hubspot\\Client), Array, 'contact', 0, 0, NULL)
#2 /home/jiminny/app/Services/Crm/Hubspot/Service.php(1203): Jiminny\\Services\\Crm\\Hubspot\\Client->getPaginatedData(Array, 'contact')
#3 /home/jiminny/app/Console/Commands/JiminnyDebugCommand.php(353): Jiminny\\Services\\Crm\\Hubspot\\Service->matchByName('Robot')
#4 /home/jiminny/app/Console/Commands/JiminnyDebugCommand.php(44): Jiminny\\Console\\Commands\\JiminnyDebugCommand->rateLimit()
#5 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): Jiminny\\Console\\Commands\\JiminnyDebugCommand->handle(Object(Jiminny\\Jobs\\JobDispatcher), Object(Jiminny\\Services\\Kiosk\\AutomatedReports\\AutomatedReportsService), Object(Jiminny\\Repositories\\AutomatedReportsRepository), Object(Jiminny\\Services\\UserPilot\\UserPilotClient))
#6 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\\Container\\BoundMethod::Illuminate\\Container\\{closure}()
#7 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(96): Illuminate\\Container\\Util::unwrapIfClosure(Object(Closure))
#8 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\\Container\\BoundMethod::callBoundMethod(Object(Illuminate\\Foundation\\Application), Array, Object(Closure))
#9 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/Container.php(799): Illuminate\\Container\\BoundMethod::call(Object(Illuminate\\Foundation\\Application), Array, Array, NULL)
#10 /home/jiminny/vendor/laravel/framework/src/Illuminate/Console/Command.php(211): Illuminate\\Container\\Container->call(Array)
#11 /home/jiminny/vendor/symfony/console/Command/Command.php(341): Illuminate\\Console\\Command->execute(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Illuminate\\Console\\OutputStyle))
#12 /home/jiminny/vendor/laravel/framework/src/Illuminate/Console/Command.php(180): Symfony\\Component\\Console\\Command\\Command->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Illuminate\\Console\\OutputStyle))
#13 /home/jiminny/vendor/symfony/console/Application.php(1117): Illuminate\\Console\\Command->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#14 /home/jiminny/vendor/symfony/console/Application.php(356): Symfony\\Component\\Console\\Application->doRunCommand(Object(Jiminny\\Console\\Commands\\JiminnyDebugCommand), Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#15 /home/jiminny/vendor/symfony/console/Application.php(195): Symfony\\Component\\Console\\Application->doRun(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#16 /home/jiminny/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(198): Symfony\\Component\\Console\\Application->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#17 /home/jiminny/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1235): Illuminate\\Foundation\\Console\\Kernel->handle(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#18 /home/jiminny/artisan(13): Illuminate\\Foundation\\Application->handleCommand(Object(Symfony\\Component\\Console\\Input\\ArgvInput))
#19 {main}
[previous exception] [object] (SevenShores\\Hubspot\\Exceptions\\BadRequest(code: 429): Client error: `POST https://api.hubapi.com/crm/v3/objects/contact/search` resulted in a `429 Too Many Requests` response:
{\"status\":\"error\",\"message\":\"You have reached your secondly limit.\",\"errorType\":\"RATE_LIMIT\",\"correlationId\":\"019e02c4-d (truncated...)
at /home/jiminny/vendor/hubspot/hubspot-php/src/Exceptions/HubspotException.php:24)
[stacktrace]
#0 /home/jiminny/vendor/hubspot/hubspot-php/src/Http/Client.php(125): SevenShores\\Hubspot\\Exceptions\\HubspotException::create(Object(GuzzleHttp\\Exception\\ClientException))
#1 /home/jiminny/app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php(166): SevenShores\\Hubspot\\Http\\Client->request('POST', 'https://api.hub...', Array)
#2 /home/jiminny/app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php(52): Jiminny\\Services\\Crm\\Hubspot\\Pagination\\HubspotPaginationService->executeSearchRequest(Object(Jiminny\\Services\\Crm\\Hubspot\\Client), 'https://api.hub...', Array, Object(Jiminny\\Services\\Crm\\Hubspot\\Pagination\\PaginationState))
#3 /home/jiminny/app/Services/Crm/Hubspot/Client.php(191): Jiminny\\Services\\Crm\\Hubspot\\Pagination\\HubspotPaginationService->getPaginatedDataGenerator(Object(Jiminny\\Services\\Crm\\Hubspot\\Client), Array, 'contact', 0, 0, NULL)
#4 /home/jiminny/app/Services/Crm/Hubspot/Service.php(1203): Jiminny\\Services\\Crm\\Hubspot\\Client->getPaginatedData(Array, 'contact')
#5 /home/jiminny/app/Console/Commands/JiminnyDebugCommand.php(353): Jiminny\\Services\\Crm\\Hubspot\\Service->matchByName('Robot')
#6 /home/jiminny/app/Console/Commands/JiminnyDebugCommand.php(44): Jiminny\\Console\\Commands\\JiminnyDebugCommand->rateLimit()
#7 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): Jiminny\\Console\\Commands\\JiminnyDebugCommand->handle(Object(Jiminny\\Jobs\\JobDispatcher), Object(Jiminny\\Services\\Kiosk\\AutomatedReports\\AutomatedReportsService), Object(Jiminny\\Repositories\\AutomatedReportsRepository), Object(Jiminny\\Services\\UserPilot\\UserPilotClient))
#8 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\\Container\\BoundMethod::Illuminate\\Container\\{closure}()
#9 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(96): Illuminate\\Container\\Util::unwrapIfClosure(Object(Closure))
#10 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\\Container\\BoundMethod::callBoundMethod(Object(Illuminate\\Foundation\\Application), Array, Object(Closure))
#11 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/Container.php(799): Illuminate\\Container\\BoundMethod::call(Object(Illuminate\\Foundation\\Application), Array, Array, NULL)
#12 /home/jiminny/vendor/laravel/framework/src/Illuminate/Console/Command.php(211): Illuminate\\Container\\Container->call(Array)
#13 /home/jiminny/vendor/symfony/console/Command/Command.php(341): Illuminate\\Console\\Command->execute(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Illuminate\\Console\\OutputStyle))
#14 /home/jiminny/vendor/laravel/framework/src/Illuminate/Console/Command.php(180): Symfony\\Component\\Console\\Command\\Command->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Illuminate\\Console\\OutputStyle))
#15 /home/jiminny/vendor/symfony/console/Application.php(1117): Illuminate\\Console\\Command->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#16 /home/jiminny/vendor/symfony/console/Application.php(356): Symfony\\Component\\Console\\Application->doRunCommand(Object(Jiminny\\Console\\Commands\\JiminnyDebugCommand), Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#17 /home/jiminny/vendor/symfony/console/Application.php(195): Symfony\\Component\\Console\\Application->doRun(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#18 /home/jiminny/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(198): Symfony\\Component\\Console\\Application->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#19 /home/jiminny/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1235): Illuminate\\Foundation\\Console\\Kernel->handle(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#20 /home/jiminny/artisan(13): Illuminate\\Foundation\\Application->handleCommand(Object(Symfony\\Component\\Console\\Input\\ArgvInput))
#21 {main}
[previous exception] [object] (GuzzleHttp\\Exception\\ClientException(code: 429): Client error: `POST https://api.hubapi.com/crm/v3/objects/contact/search` resulted in a `429 Too Many Requests` response:
{\"status\":\"error\",\"message\":\"You have reached your secondly limit.\",\"errorType\":\"RATE_LIMIT\",\"correlationId\":\"019e02c4-d (truncated...)
at /home/jiminny/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php:111)
[stacktrace]
#0 /home/jiminny/vendor/guzzlehttp/guzzle/src/Middleware.php(72): GuzzleHttp\\Exception\\RequestException::create(Object(GuzzleHttp\\Psr7\\Request), Object(GuzzleHttp\\Psr7\\Response), NULL, Array, NULL)
#1 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(209): GuzzleHttp\\Middleware::GuzzleHttp\\{closure}(Object(GuzzleHttp\\Psr7\\Response))
#2 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(158): GuzzleHttp\\Promise\\Promise::callHandler(1, Object(GuzzleHttp\\Psr7\\Response), NULL)
#3 /home/jiminny/vendor/guzzlehttp/promises/src/TaskQueue.php(52): GuzzleHttp\\Promise\\Promise::GuzzleHttp\\Promise\\{closure}()
#4 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(251): GuzzleHttp\\Promise\\TaskQueue->run(true)
#5 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(227): GuzzleHttp\\Promise\\Promise->invokeWaitFn()
#6 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(272): GuzzleHttp\\Promise\\Promise->waitIfPending()
#7 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(229): GuzzleHttp\\Promise\\Promise->invokeWaitList()
#8 /home/jiminny/vendor/guzzlehttp/promises/src/Promise.php(69): GuzzleHttp\\Promise\\Promise->waitIfPending()
#9 /home/jiminny/vendor/guzzlehttp/guzzle/src/Client.php(189): GuzzleHttp\\Promise\\Promise->wait()
#10 /home/jiminny/vendor/hubspot/hubspot-php/src/Http/Client.php(113): GuzzleHttp\\Client->request('POST', 'https://api.hub...', Array)
#11 /home/jiminny/app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php(166): SevenShores\\Hubspot\\Http\\Client->request('POST', 'https://api.hub...', Array)
#12 /home/jiminny/app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php(52): Jiminny\\Services\\Crm\\Hubspot\\Pagination\\HubspotPaginationService->executeSearchRequest(Object(Jiminny\\Services\\Crm\\Hubspot\\Client), 'https://api.hub...', Array, Object(Jiminny\\Services\\Crm\\Hubspot\\Pagination\\PaginationState))
#13 /home/jiminny/app/Services/Crm/Hubspot/Client.php(191): Jiminny\\Services\\Crm\\Hubspot\\Pagination\\HubspotPaginationService->getPaginatedDataGenerator(Object(Jiminny\\Services\\Crm\\Hubspot\\Client), Array, 'contact', 0, 0, NULL)
#14 /home/jiminny/app/Services/Crm/Hubspot/Service.php(1203): Jiminny\\Services\\Crm\\Hubspot\\Client->getPaginatedData(Array, 'contact')
#15 /home/jiminny/app/Console/Commands/JiminnyDebugCommand.php(353): Jiminny\\Services\\Crm\\Hubspot\\Service->matchByName('Robot')
#16 /home/jiminny/app/Console/Commands/JiminnyDebugCommand.php(44): Jiminny\\Console\\Commands\\JiminnyDebugCommand->rateLimit()
#17 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): Jiminny\\Console\\Commands\\JiminnyDebugCommand->handle(Object(Jiminny\\Jobs\\JobDispatcher), Object(Jiminny\\Services\\Kiosk\\AutomatedReports\\AutomatedReportsService), Object(Jiminny\\Repositories\\AutomatedReportsRepository), Object(Jiminny\\Services\\UserPilot\\UserPilotClient))
#18 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\\Container\\BoundMethod::Illuminate\\Container\\{closure}()
#19 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(96): Illuminate\\Container\\Util::unwrapIfClosure(Object(Closure))
#20 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\\Container\\BoundMethod::callBoundMethod(Object(Illuminate\\Foundation\\Application), Array, Object(Closure))
#21 /home/jiminny/vendor/laravel/framework/src/Illuminate/Container/Container.php(799): Illuminate\\Container\\BoundMethod::call(Object(Illuminate\\Foundation\\Application), Array, Array, NULL)
#22 /home/jiminny/vendor/laravel/framework/src/Illuminate/Console/Command.php(211): Illuminate\\Container\\Container->call(Array)
#23 /home/jiminny/vendor/symfony/console/Command/Command.php(341): Illuminate\\Console\\Command->execute(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Illuminate\\Console\\OutputStyle))
#24 /home/jiminny/vendor/laravel/framework/src/Illuminate/Console/Command.php(180): Symfony\\Component\\Console\\Command\\Command->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Illuminate\\Console\\OutputStyle))
#25 /home/jiminny/vendor/symfony/console/Application.php(1117): Illuminate\\Console\\Command->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#26 /home/jiminny/vendor/symfony/console/Application.php(356): Symfony\\Component\\Console\\Application->doRunCommand(Object(Jiminny\\Console\\Commands\\JiminnyDebugCommand), Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#27 /home/jiminny/vendor/symfony/console/Application.php(195): Symfony\\Component\\Console\\Application->doRun(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#28 /home/jiminny/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(198): Symfony\\Component\\Console\\Application->run(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#29 /home/jiminny/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1235): Illuminate\\Foundation\\Console\\Kernel->handle(Object(Symfony\\Component\\Console\\Input\\ArgvInput), Object(Symfony\\Component\\Console\\Output\\ConsoleOutput))
#30 /home/jiminny/artisan(13): Illuminate\\Foundation\\Application->handleCommand(Object(Symfony\\Component\\Console\\Input\\ArgvInput))
#31 {main}
"} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
[2026-05-07 14:08:39] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:batch:process","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"0b0aaffc-b17d-4e58-b762-977c85cdd0b1","trace_id":"2c3239ee-27ee-4562-b879-7185d83e71bd"}
[2026-05-07 14:08:39] local.INFO: [EmailSchedule] STARTING batch process {"host":"docker_lamp_1"} {"correlation_id":"0b0aaffc-b17d-4e58-b762-977c85cdd0b1","trace_id":"2c3239ee-27ee-4562-b879-7185d83e71bd"}
[2026-05-07 14:08:40] local.INFO: [EmailSchedule] FINISHED batch process {"host":"docker_lamp_1","processed":0} {"correlation_id":"0b0aaffc-b17d-4e58-b762-977c85cdd0b1","trace_id":"2c3239ee-27ee-4562-b879-7185d83e71bd"}
[2026-05-07 14:08:40] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:batch:process","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"0b0aaffc-b17d-4e58-b762-977c85cdd0b1","trace_id":"2c3239ee-27ee-4562-b879-7185d83e71bd"}
[2026-05-07 14:08:44] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"conference:monitor:count","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"4a0b016f-33d1-4fe7-9614-a5866168a51a","trace_id":"789fa62b-e244-461c-99c1-3cf1d571aee3"}
[2026-05-07 14:08:44] local.INFO: Running conference:monitor:count command for activities in (2026-05-07 14:06:00, 2026-05-07 14:08:00] {"correlation_id":"4a0b016f-33d1-4fe7-9614-a5866168a51a","trace_id":"789fa62b-e244-461c-99c1-3cf1d571aee3"}
[2026-05-07 14:08:44] local.INFO: [conference:monitor:count] No activities found in (2026-05-07 14:06:00, 2026-05-07 14:08:00] {"correlation_id":"4a0b016f-33d1-4fe7-9614-a5866168a51a","trace_id":"789fa62b-e244-461c-99c1-3cf1d571aee3"}
[2026-05-07 14:08:44] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"conference:monitor:count","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"4a0b016f-33d1-4fe7-9614-a5866168a51a","trace_id":"789fa62b-e244-461c-99c1-3cf1d571aee3"}
[2026-05-07 14:08:56] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:batch:retry-failed","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"6918eda6-2b33-44f0-81b2-2b857d748d9d","trace_id":"b579f82f-2e2c-4f51-90c7-176a9cb4b034"}
[2026-05-07 14:08:56] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:batch:retry-failed","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"6918eda6-2b33-44f0-81b2-2b857d748d9d","trace_id":"b579f82f-2e2c-4f51-90c7-176a9cb4b034"}
[2026-05-07 14:09:13] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"meeting-bot:schedule-bot","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"c74ba9d1-2bae-4193-bdc3-f28bb114a01a","trace_id":"b1119ae4-85e4-4811-a452-7f8bc17c9902"}
[2026-05-07 14:09:13] local.INFO: [ScheduleBotCommand] Number of activities to be captured: 0 {"correlation_id":"c74ba9d1-2bae-4193-bdc3-f28bb114a01a","trace_id":"b1119ae4-85e4-4811-a452-7f8bc17c9902"}
[2026-05-07 14:09:13] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"meeting-bot:schedule-bot","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"c74ba9d1-2bae-4193-bdc3-f28bb114a01a","trace_id":"b1119ae4-85e4-4811-a452-7f8bc17c9902"}
[2026-05-07 14:09:17] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"dialers:monitor-activities","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"4f778d97-0b0b-4d22-811e-8e28826b49d2","trace_id":"0c888693-b171-4384-9c15-ee657feac714"}
[2026-05-07 14:09:17] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"dialers:monitor-activities","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"4f778d97-0b0b-4d22-811e-8e28826b49d2","trace_id":"0c888693-b171-4384-9c15-ee657feac714"}
[2026-05-07 14:09:26] local.NOTICE: Monitoring start {"correlation_id":"27750001-5212-406e-bfb8-38a645dbcec5","trace_id":"57d40356-0102-42fc-ba6b-1ecc93535e1b"}
[2026-05-07 14:09:26] local.NOTICE: Monitoring end {"correlation_id":"27750001-5212-406e-bfb8-38a645dbcec5","trace_id":"57d40356-0102-42fc-ba6b-1ecc93535e1b"}
[2026-05-07 14:09:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"fd08a346-b729-47e2-91d6-dc845103affb","trace_id":"dfb41a84-ecc1-4054-8517-dc4b2619f036"}
[2026-05-07 14:09:31] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"fd08a346-b729-47e2-91d6-dc845103affb","trace_id":"dfb41a84-ecc1-4054-8517-dc4b2619f036"}
[2026-05-07 14:09:33] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:batch:process","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"3e6c7142-56b7-415c-8661-e5494b4e60b1","trace_id":"b7b20129-94e3-4350-937e-42d64b87cb19"}
[2026-05-07 14:09:33] local.INFO: [EmailSchedule] STARTING batch process {"host":"docker_lamp_1"} {"correlation_id":"3e6c7142-56b7-415c-8661-e5494b4e60b1","trace_id":"b7b20129-94e3-4350-937e-42d64b87cb19"}
[2026-05-07 14:09:33] local.INFO: [EmailSchedule] FINISHED batch process {"host":"docker_lamp_1","processed":0} {"correlation_id":"3e6c7142-56b7-415c-8661-e5494b4e60b1","trace_id":"b7b20129-94e3-4350-937e-42d64b87cb19"}
[2026-05-07 14:09:33] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:batch:process","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"3e6c7142-56b7-415c-8661-e5494b4e60b1","trace_id":"b7b20129-94e3-4350-937e-42d64b87cb19"}
[2026-05-07 14:09:37] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"activity:aircall:check-and-renew","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"d7ec8872-1181-403f-8d43-1616114e02a7","trace_id":"8b490662-7140-4875-880c-0b7ae10b4b83"}
[2026-05-07 14:09:37] local.INFO: [SocialAccountService] Fetching token {"socialAccountId":1496,"provider":"aircall"} {"correlation_id":"d7ec8872-1181-403f-8d43-1616114e02a7","trace_id":"8b490662-7140-4875-880c-0b7ae10b4b83"}
[2026-05-07 14:09:37] local.INFO: [SocialAccountService] Token retrieved {"socialAccountId":1496,"provider":"aircall"} {"correlation_id":"d7ec8872-1181-403f-8d43-1616114e02a7","trace_id":"8b490662-7140-4875-880c-0b7ae10b4b83"}
[2026-05-07 14:09:37] local.INFO: [EncryptedTokenManager] Generating access token. {"mode":"legacy"} {"correlation_id":"d7ec8872-1181-403f-8d43-1616114e02a7","trace_id":"8b490662-7140-4875-880c-0b7ae10b4b83"}
[2026-05-07 14:09:37] local.ERROR: [Aircall] Re-activating webhooks failed {"team_id":1,"reason":"{\"message\":\"Forbidden\"}"} {"correlation_id":"d7ec8872-1181-403f-8d43-1616114e02a7","trace_id":"8b490662-7140-4875-880c-0b7ae10b4b83"}
[2026-05-07 14:09:37] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"activity:aircall:check-and-renew","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"d7ec8872-1181-403f-8d43-1616114e02a7","trace_id":"8b490662-7140-4875-880c-0b7ae10b4b83"}
[2026-05-07 14:09:40] local.INFO: [RetryFailedDownloads] Starting {"options":{"from":null,"to":null,"help":false,"silent":false,"quiet":false,"verbose":false,"version":false,"ansi":null,"no-interaction":false,"env":null}} {"correlation_id":"3e4fee4c-1e25-454d-83aa-4fed507bc107","trace_id":"e3fb6415-fa4e-4ea2-b163-9b09f456fb0c"}
[2026-05-07 14:10:05] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"meeting-bot:schedule-bot","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"6fdce905-c1fe-4707-ab21-d9861283b19f","trace_id":"5e3454bf-e096-4363-8668-a6fffd4f6249"}
[2026-05-07 14:10:05] local.INFO: [ScheduleBotCommand] Number of activities to be captured: 0 {"correlation_id":"6fdce905-c1fe-4707-ab21-d9861283b19f","trace_id":"5e3454bf-e096-4363-8668-a6fffd4f6249"}
[2026-05-07 14:10:05] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"meeting-bot:schedule-bot","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"6fdce905-c1fe-4707-ab21-d9861283b19f","trace_id":"5e3454bf-e096-4363-8668-a6fffd4f6249"}
[2026-05-07 14:10:06] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"dialers:monitor-activities","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"1ecbe999-9c82-450c-acf9-dc89bf054b42","trace_id":"96d0b27e-b838-4f8c-9959-25ec07ae5f6e"}
[2026-05-07 14:10:06] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"dialers:monitor-activities","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"1ecbe999-9c82-450c-acf9-dc89bf054b42","trace_id":"96d0b27e-b838-4f8c-9959-25ec07ae5f6e"}
[2026-05-07 14:10:08] local.NOTICE: Monitoring start {"correlation_id":"de73b6fd-8980-4497-aafb-d2c38c47d449","trace_id":"0ae3aae5-7abf-4911-84fb-2ba6537a5d38"}
[2026-05-07 14:10:08] local.NOTICE: Monitoring end {"correlation_id":"de73b6fd-8980-4497-aafb-d2c38c47d449","trace_id":"0ae3aae5-7abf-4911-84fb-2ba6537a5d38"}
[2026-05-07 14:10:10] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"1b6708af-0228-4e34-88a3-288578822431","trace_id":"873e753a-20d2-4387-b9bc-d70791da1bff"}
[2026-05-07 14:10:10] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:skip-lists:refresh","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"1b6708af-0228-4e34-88a3-288578822431","trace_id":"873e753a-20d2-4387-b9bc-d70791da1bff"}
[2026-05-07 14:10:12] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:batch:process","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"df2612dc-5245-467e-8f65-27174c7d8c3b","trace_id":"5648bf8e-2e22-4731-80d3-bff5a73d628b"}
[2026-05-07 14:10:12] local.INFO: [EmailSchedule] STARTING batch process {"host":"docker_lamp_1"} {"correlation_id":"df2612dc-5245-467e-8f65-27174c7d8c3b","trace_id":"5648bf8e-2e22-4731-80d3-bff5a73d628b"}
[2026-05-07 14:10:12] local.INFO: [EmailSchedule] FINISHED batch process {"host":"docker_lamp_1","processed":0} {"correlation_id":"df2612dc-5245-467e-8f65-27174c7d8c3b","trace_id":"5648bf8e-2e22-4731-80d3-bff5a73d628b"}
[2026-05-07 14:10:12] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:batch:process","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"df2612dc-5245-467e-8f65-27174c7d8c3b","trace_id":"5648bf8e-2e22-4731-80d3-bff5a73d628b"}
[2026-05-07 14:10:15] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"conference:monitor:count","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"9b0e7605-875e-4e51-83d6-2b89e4612ffc","trace_id":"39633b63-5f0d-4bc8-926c-320d50b6de7b"}
[2026-05-07 14:10:15] local.INFO: Running conference:monitor:count command for activities in (2026-05-07 14:08:00, 2026-05-07 14:10:00] {"correlation_id":"9b0e7605-875e-4e51-83d6-2b89e4612ffc","trace_id":"39633b63-5f0d-4bc8-926c-320d50b6de7b"}
[2026-05-07 14:10:15] local.INFO: [conference:monitor:count] No activities found in (2026-05-07 14:08:00, 2026-05-07 14:10:00] {"correlation_id":"9b0e7605-875e-4e51-83d6-2b89e4612ffc","trace_id":"39633b63-5f0d-4bc8-926c-320d50b6de7b"}
[2026-05-07 14:10:15] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"conference:monitor:count","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"9b0e7605-875e-4e51-83d6-2b89e4612ffc","trace_id":"39633b63-5f0d-4bc8-926c-320d50b6de7b"}
[2026-05-07 14:10:18] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"activity:purge-stale","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"f2528a96-6d20-45d2-8ad4-e68fdb1b03f7","trace_id":"0852729f-18b9-4c1f-8cf8-fa9772729628"}
[2026-05-07 14:10:18] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"activity:purge-stale","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"f2528a96-6d20-45d2-8ad4-e68fdb1b03f7","trace_id":"0852729f-18b9-4c1f-8cf8-fa9772729628"}
[2026-05-07 14:10:21] local.INFO: Jiminny\Console\Commands\Command::run Memory usage before starting command {"command":"mailbox:text-relay:sync","memoryBeforeCommandInMb":62.0,"memoryPeakBeforeCommandInMb":99.727} {"correlation_id":"8d1d9ffd-c346-4e05-bd33-2346f02967fa","trace_id":"a11335d7-a43f-4152-9008-4f7112aaba0d"}
[2026-05-07 14:10:21] local.INFO: Jiminny\Console\Commands\Command::run Memory usage for command {"command":"mailbox:text-relay:sync","memoryBeforeCommandInMb":62.0,"memoryAfterCommandInMB":62.0,"memoryPeakBeforeCommandInMb":99.727,"memoryPeakAfterCommandInMB":99.727} {"correlation_id":"8d1d9ffd-c346-4e05-bd33-2346f02967fa","trace_id":"a11335d7-a43f-4152-9008-4f7112aaba0d"}...
|
PhpStorm
|
faVsco.js – laravel.log
|
NULL
|
4575
|
|
4576
|
PostmanVIewWindowmelprTavsco.sProiectRematchActivi PostmanVIewWindowmelprTavsco.sProiectRematchActivityOnCr,= custom.logE hubspot-journal-poll.log© PaginationState.php© PaginationConfig.php© SyncOpportunitiesJob.php= laravel.log<)> phpunit.xmis ttt.js© ImportOpportunityBatch.phpTImportBatchJobTrait.pl© CachedCrmServiceDecorator.phc(* Hubspot/../Syncd= oauth-onivale.keyE oauth-public.kevE storageE supervisord.picclass Cllent extends Baseclient 1mpLenw text-relav.isonv D tests> Feature→intearation→ Services115116117118>M Actions• M Comoonent> M Confiauration• IM Consold• M Contracte122123h DomainD DTOD Enums• M Events.125D Exceptionsm fixtures> D GuardsM Holnors> C Http• C Intearations> C Interactionsv @Jobs>@ Activityi> C AiAutomation> M Audidv M AutomatedReports© CreateResultsTest.phoC RequestGenerateAsk Ji(C) RequestGenerateReoo© SendReportExpiringSocSendRenort.lobliest.oh( SendRenortMaillobTes@ SendRenortNotGenera140141144145› D Calendar>M Crm> M DealPicksM Mailhox)149• @ Streaming.)m Toamorivate tunction executerequesticathrow new RateLimitsxothrow $e;2 usagespublic function isHubspotRateLimitZ usagespublic function parseRetryAfter(ThLumanate support racades Lo1f (method exists(SeSvalue = Sheaders|'Retry-.if (is arrav(Svalue)) {= Svaluel0l?if Gs numeric(svalue)) «ceturn ant. Svalue:Scurrent = $e;whiile Scunnent 1== null.if (method_exists($currentSnecnonce = Ceunnent.if (Sresponse !== nul1Choadene = SnecnorSaunnont - Caunnont-sao+p.Sthis->loq->info('[Hubspot] DE'headers' => Sheaders 22 [C TelephonyMiicor(et ImnartD.1:$0: Lukas/Stefka 121 - in 20 m100% L2Thu 7 May 17:10:28• SearchUparadeYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaborationv COLLECtIONS> CRM Owners> CRM Pipelines• Dealsengagements> D OLD ENGAGEMENTSuer list meetingsGET read call> post soarch calleGET ist callsPOST meetings scheduledGET det meetinoPOST get link to task> POST Create Contact with Association› Hubspotvteration run HSv GET Read Copyeg. An error occurred.se. successful operationv lteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESCAPCHSEARCHIPost search contact by phonePOST search contact by emailpost coarch meetinaspost Search callc vaPOST Search related meetinas v3Post coarch deals> Ticketsv Uicofull> PoST filter per comoanv / onlv open deal stagesGet engagements old associated by dealments old associated by companvSustem Resource WarningSustem resources are constrained. Thesystem mav not be able to generate the loadeded for this test and the cest is likely toa Connect GitConcole 5.) TerminaPOST search de • POST Reada bal • POST Read a bat eGET ReadGET ReadGET read callGET Get EngageGET Read CopyGET httos:/lapi.rm lteration run HSPOST search contaPOSt search conta• Iteration run SD Iteration run SelNo environmentH7).u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:21 (1 min) • Fixed profileSummaryTotal requests sent ©6.550Requests/second ©Avg. response time ©P90 ©109.04155 ms173 msp95 O196 msP99 ©287 msError % ©0,00Failure % ©Peak CPU % ©Peak Memory % ©0,00100.0 %195 %Filter bv requestsvAva. response% 100262 ms 140 req/s25017•08.25|17-08-2117•08•2717•08•4617•08•4917-08-55)17•09•0117•09•0717.09-1217.09-19- Requests/second - Ava. response - Error % - Virtual users ..• CPU % ••• Memory %Dorformonss dotolle fortotol durotinnPOST search contact by email Copy6.550108.480.00Failure %0.00Resp. time (Ava. ms)Min (ms)Max ms)693287Globals Vault Tools?000...
|
iTerm2
|
NULL
|
NULL
|
4576
|
|
4577
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Close
Share chat
Claude finished the response
You said: So just a solution for rate limit implementation.
You said: So just a solution for rate limit implementation.
So just a solution for rate limit implementation. The situation currently is that there are some daily and secondary limits for HubSpot. I would like to make sure I never reach a 429 error rate limit. The requests can come from any flow. It can be:
updating activity (engagement, meeting, call, note)
searching for a company or contact
updating deal
patching IDs
Review what the limit is at the moment in the HubSpot documentation and then think of the solution:
where to store it
how to read it
how to work with multiple jobs
how to work with paginated requests Let's consider a situation when there are 600 opportunities to sync. What would be the flow? How would the rate limit be recognized? How would it be handled? What are the potential issues? [API usage guidelines and limits - HubSpot docs](
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
). Example of such a error Client error:
POST https://api.hubapi.com/crm/v3/objects/contact/search
resulted in a
429 Too Many Requests
response: {"status":"error","message":"You have reached your secondly limit.","errorType":"RATE_LIMIT","correlationId":"019dffc4-4 (truncated...). Think carefully about the implementation and potential issue and bottlenecks.
Show more
10:42
Retry
Edit
Copy
Claude responded: Current HubSpot limits (Apr 2026)
Claude responded: Current HubSpot limits (Apr 2026)
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Current HubSpot limits (Apr 2026)
Current HubSpot limits (Apr 2026)
For privately distributed apps (which is what Jiminny presumably uses with HubSpot), the limits are layered: a per-app burst window of 100/10s on Free/Starter, 190/10s on Pro/Enterprise, or 250/10s with the API Limit Increase add-on
, plus a per-account daily cap of 250k / 625k / 1M depending on tier — shared across all private apps in the account
. The burst window is per app; the daily quota is per portal.
hubspot
hubspot
hubspot
hubspot
The Search API is special: five requests per second per account, capped at 200 records per page, with a hard 10,000-result ceiling per query
. That's the limit the 429 in your example is hitting (
secondly limit
on
/crm/v3/objects/contact/search
). It's a separate bucket from the 190/10s, and critically, search responses do not include the
X-HubSpot-RateLimit-*
headers
— you can't read remaining capacity off the response, you have to track it yourself.
hubspot
hubspot
hubspot
hubspot
Non-search endpoints return
X-HubSpot-RateLimit-Remaining
,
-Max
, and
-Interval-Milliseconds
. The daily headers are not returned for OAuth-authenticated calls
, so for those you check the account-info endpoint or maintain your own counter. There's also a soft rule: errors should stay under 5% of total daily requests
— that's enforced for marketplace listing, but it's also a sane operational target.
hubspot
hubspot
hubspot
hubspot
So you have
four buckets
to track at minimum: app-burst (10s sliding), search-secondly (1s sliding), account-daily (24h fixed, midnight in HubSpot's TZ), and per-app daily share (your own budgeting on top of the account cap).
Where to store it
Where to store it
Redis. It's the only realistic option once you have multiple queue workers — DB-backed counters serialize too much, and in-process state can't coordinate across workers. Laravel already speaks Redis natively, and you get atomic
INCR
/
EXPIRE
plus Lua scripting for true CAS semantics.
Key layout I'd use:
Copy to clipboard
hubspot:rl:burst:{portalId}:{appId} ZSET (sliding 10s)
hubspot:rl:search:{portalId} ZSET (sliding 1s)
hubspot:rl:daily:{portalId} STRING + TTL to midnight TZ
hubspot:rl:meta:{portalId} HASH (last seen headers)
The two short-window buckets are sliding-window-log (Redis ZSET, score =
microtime
, member = unique request id). Lua script removes entries older than the window, counts remaining slots, and only adds the new one if there's room — all atomic. Fixed windows are simpler but allow 2× the limit at the boundary, which on a 5/s window is brutal.
The daily bucket is a plain
INCR
with TTL set to seconds-until-midnight in
HubSpot's account timezone
, not yours — Sofia is UTC+2/+3 but your portal might be set to US Eastern. Get this once and cache it.
How to read it
How to read it
Two-phase: optimistic pre-check, authoritative post-update.
Before a call, run the Lua acquire script. If it returns "denied," sleep until a slot frees up (the script can return ms-until-next-slot) or push the job back to the queue with a delay. Don't busy-loop.
After the call, parse
X-HubSpot-RateLimit-Remaining
/
-Max
/
-Interval-Milliseconds
and store them in...
|
Claude
|
Claude
|
NULL
|
4577
|
|
4578
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Close
Share chat
Claude finished the response
You said: So just a solution for rate limit implementation.
You said: So just a solution for rate limit implementation.
So just a solution for rate limit implementation. The situation currently is that there are some daily and secondary limits for HubSpot. I would like to make sure I never reach a 429 error rate limit. The requests can come from any flow. It can be:
updating activity (engagement, meeting, call, note)
searching for a company or contact
updating deal
patching IDs
Review what the limit is at the moment in the HubSpot documentation and then think of the solution:
where to store it
how to read it
how to work with multiple jobs
how to work with paginated requests Let's consider a situation when there are 600 opportunities to sync. What would be the flow? How would the rate limit be recognized? How would it be handled? What are the potential issues? [API usage guidelines and limits - HubSpot docs](
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
). Example of such a error Client error:
POST https://api.hubapi.com/crm/v3/objects/contact/search
resulted in a
429 Too Many Requests
response: {"status":"error","message":"You have reached your secondly limit.","errorType":"RATE_LIMIT","correlationId":"019dffc4-4 (truncated...). Think carefully about the implementation and potential issue and bottlenecks.
Show more
10:42
Retry
Edit
Copy
Claude responded: Current HubSpot limits (Apr 2026)
Claude responded: Current HubSpot limits (Apr 2026)
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Current HubSpot limits (Apr 2026)
Current HubSpot limits (Apr 2026)
For privately distributed apps (which is what Jiminny presumably uses with HubSpot), the limits are layered: a per-app burst window of 100/10s on Free/Starter, 190/10s on Pro/Enterprise, or 250/10s with the API Limit Increase add-on
, plus a per-account daily cap of 250k / 625k / 1M depending on tier — shared across all private apps in the account
. The burst window is per app; the daily quota is per portal.
hubspot
hubspot
hubspot
hubspot
The Search API is special: five requests per second per account, capped at 200 records per page, with a hard 10,000-result ceiling per query
. That's the limit the 429 in your example is hitting (
secondly limit
on
/crm/v3/objects/contact/search
). It's a separate bucket from the 190/10s, and critically, search responses do not include the
X-HubSpot-RateLimit-*
headers
— you can't read remaining capacity off the response, you have to track it yourself.
hubspot
hubspot
hubspot
hubspot
Non-search endpoints return
X-HubSpot-RateLimit-Remaining
,
-Max
, and
-Interval-Milliseconds
. The daily headers are not returned for OAuth-authenticated calls
, so for those you check the account-info endpoint or maintain your own counter. There's also a soft rule: errors should stay under 5% of total daily requests
— that's enforced for marketplace listing, but it's also a sane operational target.
hubspot
hubspot
hubspot
hubspot
So you have
four buckets
to track at minimum: app-burst (10s sliding), search-secondly (1s sliding), account-daily (24h fixed, midnight in HubSpot's TZ), and per-app daily share (your own budgeting on top of the account cap).
Where to store it
Where to store it
Redis. It's the only realistic option once you have multiple queue workers — DB-backed counters serialize too much, and in-process state can't coordinate across workers. Laravel already speaks Redis natively, and you get atomic
INCR
/
EXPIRE
plus Lua scripting for true CAS semantics.
Key layout I'd use:
Copy to clipboard
hubspot:rl:burst:{portalId}:{appId} ZSET (sliding 10s)
hubspot:rl:search:{portalId} ZSET (sliding 1s)
hubspot:rl:daily:{portalId} STRING + TTL to midnight TZ
hubspot:rl:meta:{portalId} HASH (last seen headers)
The two short-window buckets are sliding-window-log (Redis ZSET, score =
microtime
, member = unique request id). Lua script removes entries older than the window, counts remaining slots, and only adds the new one if there's room — all atomic. Fixed windows are simpler but allow 2× the limit at the boundary, which on a 5/s window is brutal.
The daily bucket is a plain
INCR
with TTL set to seconds-until-midnight in
HubSpot's account timezone
, not yours — Sofia is UTC+2/+3 but your portal might be set to US Eastern. Get this once and cache it.
How to read it
How to read it
Two-phase: optimistic pre-check, authoritative post-update.
Before a call, run the Lua acquire script. If it returns "denied," sleep until a slot frees up (the script can return ms-until-next-slot) or push the job back to the queue with a delay. Don't busy-loop.
After the call, parse
X-HubSpot-RateLimit-Remaining
/
-Max
/
-Interval-Milliseconds
and store them in
hubspot:rl:meta:{portalId}
. This is your reality check — if your local counter says 50 remaining but HubSpot's header says 5, you trust HubSpot and clamp your counter. This handles clock drift, missed accounting (e.g., crashed worker that took a token but never made the request), and other apps in the same account consuming the daily budget invisibly.
For search specifically, since headers don't come back, the local counter
is
the source of truth — meaning if you ever crash mid-flight, you've under-counted. Always release tokens on connection-level failure but
not
on 429 (you really did make that request).
How to work with multiple jobs
How to work with multiple jobs...
|
Claude
|
Claude
|
NULL
|
4578
|
|
4579
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Close
Share chat
Claude finished the response
You said: So just a solution for rate limit implementation.
You said: So just a solution for rate limit implementation.
So just a solution for rate limit implementation. The situation currently is that there are some daily and secondary limits for HubSpot. I would like to make sure I never reach a 429 error rate limit. The requests can come from any flow. It can be:
updating activity (engagement, meeting, call, note)
searching for a company or contact
updating deal
patching IDs
Review what the limit is at the moment in the HubSpot documentation and then think of the solution:
where to store it
how to read it
how to work with multiple jobs
how to work with paginated requests Let's consider a situation when there are 600 opportunities to sync. What would be the flow? How would the rate limit be recognized? How would it be handled? What are the potential issues? [API usage guidelines and limits - HubSpot docs](
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
). Example of such a error Client error:
POST https://api.hubapi.com/crm/v3/objects/contact/search
resulted in a
429 Too Many Requests
response: {"status":"error","message":"You have reached your secondly limit.","errorType":"RATE_LIMIT","correlationId":"019dffc4-4 (truncated...). Think carefully about the implementation and potential issue and bottlenecks.
Show more
10:42
Retry
Edit
Copy
Claude responded: Current HubSpot limits (Apr 2026)
Claude responded: Current HubSpot limits (Apr 2026)
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Current HubSpot limits (Apr 2026)
Current HubSpot limits (Apr 2026)
For privately distributed apps (which is what Jiminny presumably uses with HubSpot), the limits are layered: a per-app burst window of 100/10s on Free/Starter, 190/10s on Pro/Enterprise, or 250/10s with the API Limit Increase add-on
, plus a per-account daily cap of 250k / 625k / 1M depending on tier — shared across all private apps in the account
. The burst window is per app; the daily quota is per portal.
hubspot
hubspot
hubspot
hubspot
The Search API is special: five requests per second per account, capped at 200 records per page, with a hard 10,000-result ceiling per query
. That's the limit the 429 in your example is hitting (
secondly limit
on
/crm/v3/objects/contact/search...
|
Claude
|
Claude
|
NULL
|
4579
|
|
4580
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Close
Share chat
Claude finished the response
You said: So just a solution for rate limit implementation.
You said: So just a solution for rate limit implementation.
So just a solution for rate limit implementation. The situation currently is that there are some daily and secondary limits for HubSpot. I would like to make sure I never reach a 429 error rate limit. The requests can come from any flow. It can be:
updating activity (engagement, meeting, call, note)
searching for a company or contact
updating deal
patching IDs
Review what the limit is at the moment in the HubSpot documentation and then think of the solution:
where to store it
how to read it
how to work with multiple jobs
how to work with paginated requests Let's consider a situation when there are 600 opportunities to sync. What would be the flow? How would the rate limit be recognized? How would it be handled? What are the potential issues? [API usage guidelines and limits - HubSpot docs](
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
). Example of such a error Client error:
POST https://api.hubapi.com/crm/v3/objects/contact/search
resulted in a
429 Too Many Requests
response: {"status":"error","message":"You have reached your secondly limit.","errorType":"RATE_LIMIT","correlationId":"019dffc4-4 (truncated...). Think carefully about the implementation and potential issue and bottlenecks.
Show more
10:42
Retry
Edit
Copy
Claude responded: Current HubSpot limits (Apr 2026)
Claude responded: Current HubSpot limits (Apr 2026)
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Current HubSpot limits (Apr 2026)
Current HubSpot limits (Apr 2026)
For privately distributed apps (which is what Jiminny presumably uses with HubSpot), the limits are layered: a per-app burst window of 100/10s on Free/Starter, 190/10s on Pro/Enterprise, or 250/10s with the API Limit Increase add-on
, plus a per-account daily cap of 250k / 625k / 1M depending on tier — shared across all private apps in the account
. The burst window is per app; the daily quota is per portal.
hubspot
hubspot
hubspot
hubspot
The Search API is special: five requests per second per account, capped at 200 records per page, with a hard 10,000-result ceiling per query
. That's the limit the 429 in your example is hitting (
secondly limit
on
/crm/v3/objects/contact/search
). It's a separate bucket from the 190/10s, and critically, search responses do not include the
X-HubSpot-RateLimit-*
headers
— you can't read remaining capacity off the response, you have to track it yourself.
hubspot
hubspot
hubspot
hubspot
Non-search endpoints return
X-HubSpot-RateLimit-Remaining
,
-Max
, and
-Interval-Milliseconds
. The daily headers are not returned for OAuth-authenticated calls
, so for those you check the account-info endpoint or maintain your own counter. There's also a soft rule: errors should stay under 5% of total daily requests
— that's enforced for marketplace listing, but it's also a sane operational target.
hubspot
hubspot
hubspot
hubspot
So you have
four buckets
to track at minimum: app-burst (10s sliding), search-secondly (1s sliding), account-daily (24h fixed, midnight in HubSpot's TZ), and per-app daily share (your own budgeting on top of the account cap).
Where to store it
Where to store it
Redis. It's the only realistic option once you have multiple queue workers — DB-backed counters serialize too much, and in-process state can't coordinate across workers. Laravel already speaks Redis natively, and you get atomic
INCR
/
EXPIRE
plus Lua scripting for true CAS semantics.
Key layout I'd use:
Copy to clipboard
hubspot:rl:burst:{portalId}:{appId} ZSET (sliding 10s)
hubspot:rl:search:{portalId} ZSET (sliding 1s)
hubspot:rl:daily:{portalId} STRING + TTL to midnight TZ
hubspot:rl:meta:{portalId} HASH (last seen headers)
The two short-window buckets are sliding-window-log (Redis ZSET, score =
microtime
, member = unique request id). Lua script removes entries older than the window, counts remaining slots, and only adds the new one if there's room — all atomic. Fixed windows are simpler but allow 2× the limit at the boundary, which on a 5/s window is brutal.
The daily bucket is a plain
INCR
with TTL set to seconds-until-midnight in
HubSpot's account timezone
, not yours — Sofia is UTC+2/+3 but your portal might be set to US Eastern. Get this once and cache it.
How to read it
How to read it
Two-phase: optimistic pre-check, authoritative post-update.
Before a call, run the Lua acquire script. If it returns "denied," sleep until a slot frees up (the script can return ms-until-next-slot) or push the job back to the queue with a delay. Don't busy-loop.
After the call, parse
X-HubSpot-RateLimit-Remaining
/
-Max
/
-Interval-Milliseconds
and store them in
hubspot:rl:meta:{portalId}
. This is your reality check — if your local counter says 50 remaining but HubSpot's header says 5, you trust HubSpot and clamp your counter. This handles clock drift, missed accounting (e.g., crashed worker that took a token but never made the request), and other apps in the same account consuming the daily budget invisibly.
For search specifically, since headers don't come back, the local counter
is
the source of truth — meaning if you ever crash mid-flight, you've under-counted. Always release tokens on connection-level failure but
not
on 429 (you really did make that request).
How to work with multiple jobs
How to work with multiple jobs
The queue layer needs to enforce concurrency separately from the rate limiter. Both work together:
Concurrency cap
via
Queue::throttle()
or a Redis semaphore — limits how many sync workers run in parallel against HubSpot. Without this, you can have 50 workers all blocked waiting for tokens, which is wasteful and creates retry storms.
Per-tenant fairness
— if you sync many Jiminny customers into different HubSpot portals, each portal has its own bucket but you still want one slow portal not to starve others. Either separate queues per portal or a fair-share scheduler.
Priority lanes
— webhook-driven updates (user-visible latency) should outrank background batch syncs. Two queues:
hubspot-priority
and
hubspot-bulk
, with priority workers taking 70% of the burst budget and bulk taking 30% (enforce via separate sub-buckets if you really want hard separation, otherwise just pull from priority first).
Backoff on 429
— respect the
Retry-After
header. If absent, exponential with jitter (e.g.,
min(2^attempt * 250ms, 30s) ± 20%
). The jitter is non-negotiable; without it, simultaneous 429s retry in lockstep and you get thundering-herd 429s on retry.
How to work with paginated requests
How to work with paginated requests
The trap is treating "fetch all" as one logical operation. Each page is its own API call and competes for tokens with everything else.
Two practical rules:
Don't hold the worker idle while paginating.
If page N takes 500ms and page N+1 needs to wait 800ms for a token, you've burned 800ms of worker time doing nothing. Instead, fetch page N, dispatch the
processing
of page N as a separate job, and queue a "fetch page N+1" job with a delay equal to the wait time. Each page becomes its own atomic unit.
Always batch where HubSpot offers it.
POST /crm/v3/objects/{type}/batch/{read|update|create}
accepts up to 100 IDs per call. For your "patching IDs" flow this is the difference between 600 calls and 6.
Walkthrough: 600 opportunities
Walkthrough: 600 opportunities
Naive flow (one PATCH per deal): 600 calls. At 190/10s that's ~32s of API time, well under daily. You'd hit burst easily without throttling. Plus likely 1-3 search calls upfront and N association calls.
Sane flow:
Identify deltas
— if you can avoid Search at all, do. Use
lastmodifieddate
filter on a single search if you must, paginate at limit=200. For 600 deals that's 3 search calls @ 5/s = ~600ms naturally throttled.
Batch read
current state —
POST /crm/v3/objects/deals/batch/read
with 100 IDs per call → 6 calls. Burst weight 6.
Compute diff
in your code (no API).
Batch update
—
POST /crm/v3/objects/deals/batch/update
with 100 per call → 6 calls.
Associations
—
POST /crm/v4/associations/{from}/{to}/batch/create
if needed → another few batch calls.
Total: ~15-20 API calls for 600 deals. Burst budget consumed: 20/190 over ~5s. Daily impact: trivial.
Recognition: pre-check denies if
<weight>
slots aren't free; on 429 the response surfaces
policyName
(DAILY/SECONDLY) — log it, push the job back with
Retry-After
delay, increment a metric so you can alarm on sustained 429 rate.
Pitfalls & bottlenecks worth pre-empting
Pitfalls & bottlenecks worth pre-empting
Daily quota is shared across the whole portal
, including any n8n flows, other private apps, marketing automation calling APIs, etc. Budget for ~70-80% of the documented limit, not 100%. Add an internal per-app daily cap so a runaway sync can't starve other apps.
Search is uniquely fragile
: separate 5/s bucket, no headers to read, 10k-result cap per query. If you ever hit 10k+ deals matching a filter, partition by
hs_object_id
ranges or by
lastmodifieddate
windows.
Retry storms after HubSpot incidents
— always jitter, always cap total retries (e.g., 5 attempts, then dead-letter).
Webhook → sync → webhook loops
— when your update fires a HubSpot webhook that triggers another sync. Tag your own writes (e.g., a custom property
jy_last_sync_id
) and ignore webhooks where it just changed.
Token refresh
— OAuth refresh itself counts against burst. Cache the access token in Redis with TTL =
expires_in - 60s
, single-flight the refresh (only one worker refreshes; others wait on a lock).
Search latency for fresh writes
— newly created/updated objects don't appear in search instantly. Don't write-then-search; use returned IDs directly.
Clock skew
— Redis is authoritative. Don't use
time()
from each worker for window scoring; use
redis.call('TIME')
inside the Lua script.
Dead workers with held tokens
— sliding-window-log handles this naturally because tokens expire by score; token-bucket implementations need explicit release-on-crash logic.
The 5% error rule
counts every 429 toward your error budget, even successfully retried ones. If your pre-check is working well, 429s should be near zero — if they're not, your pre-check is wrong, not just slow.
Phantom contention with Laravel
RateLimited
middleware
: it's per-job-class by default, not per-portal. If your
SyncDealJob
and
UpdateActivityJob
are different classes both calling HubSpot, they don't share a Laravel-level limiter — you need a single
HubspotRateLimiter
service that everything routes through.
If you want, I can sketch the Lua script for the sliding-window acquire and the Laravel service wrapper around it.
Copy
Give positive feedback
Give negative feedback
Retry
You said: What will happen if there are two different types of rate limits?
You said: What will happen if there are two different types of rate limits?
What will happen if there are two different types of rate limits?
Search requests that have 5 requests per second
The other rate limit that has, let's say, 100 requests per 10 seconds How do these work together? Is there some conflict? Can I reach the limit with one request and block either as well, or are these separated? Can I still continue making search requests once I hit the normal requests limits?
13:40
Retry
Edit
Copy
Claude responded: They're independent buckets — with one shared bucket on top.
Claude responded: They're independent buckets — with one shared bucket on top.
Analyzed independent rate limit buckets and their practical interactions...
|
Claude
|
Claude
|
NULL
|
4580
|
|
4581
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
ClaudeFileEditVIeWWindowHelpHubSpot rate limit implementation strategythis is the headers I getWrite a message…Opus 4.7 Adaptive ~Hubspot rate limits reference - MDCopyUse timeZone to interpret resetsAt from the daily endpoint.Cheat sheet: profiling a new portal in PostmanThree calls, in order:1. GET /account-into/vs/details → portalinto + read durst neaders trom responseGET /account-info/v3/api-usage/daily/private-apps → daily limits (onlymeaningful for private apps)3. Skip search probing — the 5/sec is fixedError response shape"status""error"."message": "You have reached your secondly limit.","errorType" : "RATE_LIMIT","policyName" : "SECONDLY","...","requestiotnolncvname values.SECONDLY - search bucket (5/sec)• TEN_SECONDLY_ROLLING - burst bucket (110/10s for OAuth, 100-250/10s forprivate)• DAILY — private apps daily ceilingAlways inspect policyName on 429 to know which bucket fired and which queue toback off.Other operational guidelines• Error responses must stay under 5% of total daily requests for marketplacecertificationi• Polling endpoints: minimum interval 5 minutes.• Search query: max 3,000 chars, max 18 filters across 5 filter groups, max 10,000 totalresults per query.• Batch endpoints: up to 100 records per call (read create update).• Searchwho can edit, or upgrade to restore collaboration.GET ReadGET read call • GET Get Engage •$0Lukas/Stefka 121 • in 20mGET Read CopyGET https://api.tIteration run HSPOST search contaPOST search conta© Iteration run Se100% L2Thu 7 May 17:10:45UparadeIteration run SeNo environmentAvg. response time ©155 msP90 ©173 msP9S ©196 msP99 ©287 msError % ©0,00Failure % ©0,00Peak CPU % ©100.0 %Peak Memory % ©195 %Filter bv reauestsvAva. response262 ms 140 req/s25017•08•4617•08•4917-08-55)17•09•016,550108.48Error %0.00Falture %0.00Resp. time (Ava. ms)17:09:0717.09-1217.09-19- Requests/second - Ava. response - Error % - Virtual users ..• CPU % •• Memory %Min (ms)Max (ms)693287Globals Vault Tools 5000...
|
Claude
|
Claude
|
NULL
|
4581
|
|
4582
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Close
Share chat
Claude finished the response
You said: So just a solution for rate limit implementation.
You said: So just a solution for rate limit implementation.
So just a solution for rate limit implementation. The situation currently is that there are some daily and secondary limits for HubSpot. I would like to make sure I never reach a 429 error rate limit. The requests can come from any flow. It can be:
updating activity (engagement, meeting, call, note)
searching for a company or contact
updating deal
patching IDs
Review what the limit is at the moment in the HubSpot documentation and then think of the solution:
where to store it
how to read it
how to work with multiple jobs
how to work with paginated requests Let's consider a situation when there are 600 opportunities to sync. What would be the flow? How would the rate limit be recognized? How would it be handled? What are the potential issues? [API usage guidelines and limits - HubSpot docs](
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
). Example of such a error Client error:
POST https://api.hubapi.com/crm/v3/objects/contact/search
resulted in a
429 Too Many Requests
response: {"status":"error","message":"You have reached your secondly limit.","errorType":"RATE_LIMIT","correlationId":"019dffc4-4 (truncated...). Think carefully about the implementation and potential issue and bottlenecks.
Show more
10:42
Retry
Edit
Copy
Claude responded: Current HubSpot limits (Apr 2026)
Claude responded: Current HubSpot limits (Apr 2026)
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Synthesized HubSpot rate limit architecture with Redis storage and sliding window algorithms
Current HubSpot limits (Apr 2026)
Current HubSpot limits (Apr 2026)
For privately distributed apps (which is what Jiminny presumably uses with HubSpot), the limits are layered: a per-app burst window of 100/10s on Free/Starter, 190/10s on Pro/Enterprise, or 250/10s with the API Limit Increase add-on
, plus a per-account daily cap of 250k / 625k / 1M depending on tier — shared across all private apps in the account
. The burst window is per app; the daily quota is per portal.
hubspot
hubspot
hubspot
hubspot
The Search API is special: five requests per second per account, capped at 200 records per page, with a hard 10,000-result ceiling per query
. That's the limit the 429 in your example is hitting (
secondly limit
on
/crm/v3/objects/contact/search
). It's a separate bucket from the 190/10s, and critically, search responses do not include the
X-HubSpot-RateLimit-*
headers
— you can't read remaining capacity off the response, you have to track it yourself.
hubspot
hubspot
hubspot
hubspot
Non-search endpoints return
X-HubSpot-RateLimit-Remaining
,
-Max
, and
-Interval-Milliseconds
. The daily headers are not returned for OAuth-authenticated calls
, so for those you check the account-info endpoint or maintain your own counter. There's also a soft rule: errors should stay under 5% of total daily requests
— that's enforced for marketplace listing, but it's also a sane operational target.
hubspot
hubspot
hubspot
hubspot
So you have
four buckets
to track at minimum: app-burst (10s sliding), search-secondly (1s sliding), account-daily (24h fixed, midnight in HubSpot's TZ), and per-app daily share (your own budgeting on top of the account cap).
Where to store it
Where to store it...
|
Claude
|
Claude
|
NULL
|
4582
|
|
4583
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Claude is responding
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Edit
Copy
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Stop response
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes
Auto-discoverable per portal
Fixed at 5 req/sec, only confirmable via 429
Private apps only — OAuth has no daily limit
Bucket
How to check
Notes
1. Burst limit
1. Burst limit
Make any non-search call and read the
response headers
(not body).
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Headers in response:
Header
Meaning
X-HubSpot-RateLimit-Max
Burst ceiling
X-HubSpot-RateLimit-Remaining
Calls left in current window
X-HubSpot-RateLimit-Interval-Milliseconds
Window size, always
10000
X-HubSpot-RateLimit-Secondly
Deprecated, ignore
X-HubSpot-RateLimit-Secondly-Remaining
Deprecated, ignore
Header
X-HubSpot-RateLimit-Max
X-HubSpot-RateLimit-Remaining
X-HubSpot-RateLimit-Interval-Milliseconds
X-HubSpot-RateLimit-Secondly
X-HubSpot-RateLimit-Secondly-Remaining
Meaning
Burst ceiling
Calls left in current window
Window size, always
10000
Deprecated, ignore
Deprecated, ignore
Header
Meaning
Inferring app type from Max
Inferring app type from
Max
Max
value
App type
100
Free/Starter private app
110
Public OAuth app (marketplace)
190
Pro/Enterprise private app
250
Private app + API Limit Increase add-on
Max
value
100
110
190
250
App type
Free/Starter private app
Public OAuth app (marketplace)
Pro/Enterprise private app
Private app + API Limit Increase add-on
Max
value
App type
The API Limit Increase add-on does
not
raise the limit for public OAuth apps.
2. Search limit
2. Search limit
Cannot be queried.
No endpoint, no headers (search responses strip them).
Fixed constant:
5 requests per second per portal
. The 10,000-result ceiling per query and 200-records-per-page also apply.
Only confirmable by deliberately triggering a 429:
Copy to clipboard...
|
Claude
|
Claude
|
NULL
|
4583
|
|
4584
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Claude is responding
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Edit
Copy
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Stop response
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes
Auto-discoverable per portal
Fixed at 5 req/sec, only confirmable via 429
Private apps only — OAuth has no daily limit
Bucket
How to check
Notes
1. Burst limit
1. Burst limit
Make any non-search call and read the
response headers
(not body).
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Headers in response:
Header
Meaning
X-HubSpot-RateLimit-Max
Burst ceiling
X-HubSpot-RateLimit-Remaining
Calls left in current window
X-HubSpot-RateLimit-Interval-Milliseconds
Window size, always
10000
X-HubSpot-RateLimit-Secondly
Deprecated, ignore
X-HubSpot-RateLimit-Secondly-Remaining
Deprecated, ignore
Header
X-HubSpot-RateLimit-Max
X-HubSpot-RateLimit-Remaining
X-HubSpot-RateLimit-Interval-Milliseconds
X-HubSpot-RateLimit-Secondly
X-HubSpot-RateLimit-Secondly-Remaining
Meaning
Burst ceiling
Calls left in current window
Window size, always
10000
Deprecated, ignore
Deprecated, ignore
Header
Meaning
Inferring app type from Max
Inferring app type from
Max
Max
value
App type
100
Free/Starter private app
110
Public OAuth app (marketplace)
190
Pro/Enterprise private app
250
Private app + API Limit Increase add-on
Max
value
100
110
190
250
App type
Free/Starter private app
Public OAuth app (marketplace)
Pro/Enterprise private app
Private app + API Limit Increase add-on
Max
value...
|
Claude
|
Claude
|
NULL
|
4584
|
|
4585
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Claude is responding
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Edit
Copy
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
**P
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Stop response
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes
Auto-discoverable per portal
Fixed at 5 req/sec, only confirmable via 429
Private apps only — OAuth has no daily limit
Bucket
How to check
Notes
1. Burst limit
1. Burst limit
Make any non-search call and read the
response headers
(not body).
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Headers in response:
Header
Meaning
X-HubSpot-RateLimit-Max
Burst ceiling
X-HubSpot-RateLimit-Remaining
Calls left in current window
X-HubSpot-RateLimit-Interval-Milliseconds
Window size, always
10000
X-HubSpot-RateLimit-Secondly
Deprecated, ignore
X-HubSpot-RateLimit-Secondly-Remaining
Deprecated, ignore
Header
X-HubSpot-RateLimit-Max
X-HubSpot-RateLimit-Remaining
X-HubSpot-RateLimit-Interval-Milliseconds
X-HubSpot-RateLimit-Secondly
X-HubSpot-RateLimit-Secondly-Remaining
Meaning
Burst ceiling
Calls left in current window
Window size, always
10000
Deprecated, ignore
Deprecated, ignore
Header
Meaning
Inferring app type from Max
Inferring app type from
Max
Max
value
App type
100
Free/Starter private app
110
Public OAuth app (marketplace)
190
Pro/Enterprise private app
250
Private app + API Limit Increase add-on
Max
value
100
110
190
250
App type
Free/Starter private app
Public OAuth app (marketplace)
Pro/Enterprise private app
Private app + API Limit Increase add-on
Max
value
App type
The API Limit Increase add-on does
not
raise the limit for public OAuth apps.
2. Search limit
2. Search limit
Cannot be queried.
No endpoint, no headers (search responses strip them).
Fixed constant:
5 requests per second per portal
. The 10,000-result ceiling per query and 200-records-per-page also apply.
Only confirmable by deliberately triggering a 429:
Copy to clipboard
json
{
"status"
:
"error"
,
"message"
:
"You have reached your secondly limit."
,
"errorType"
:
"RATE_LIMIT"
,
"policyName"
:
"SECONDLY"
}
policyName: "SECONDLY"
from a search endpoint = search bucket. Track this server-side; HubSpot won't help.
3. Daily limit
3. Daily limit
Public OAuth apps: no daily limit
Public OAuth apps:
no daily limit
Skip the daily bucket entirely. OAuth apps are constrained by burst (110/10s) only. Theoretical max sustained = 950,400 calls/day per portal.
Private apps: query the endpoint
Private apps: query the endpoint
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/api-usage/daily/private-apps
Authorization
:
Bearer {portal_access_token}
Returns:
Copy to clipboard
json
{
"results"
:
[
{
"name"
:
"private-apps-api-calls-daily"
,
"usageLimit"
:
1000000
,
"currentUsage"
:
47213
,
"collectedAt"
:
"2026-05-07T11:23:01.362Z"
,
"fetchStatus"
:
"SUCCESS"
,
"resetsAt"...
|
Claude
|
Claude
|
NULL
|
4585
|
|
4586
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Claude is responding
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Edit
Copy
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budg
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Stop response
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes
Auto-discoverable per portal
Fixed at 5 req/sec, only confirmable via 429
Private apps only — OAuth has no daily limit
Bucket
How to check
Notes
1. Burst limit
1. Burst limit
Make any non-search call and read the
response headers
(not body).
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Headers in response:
Header
Meaning
X-HubSpot-RateLimit-Max
Burst ceiling
X-HubSpot-RateLimit-Remaining
Calls left in current window
X-HubSpot-RateLimit-Interval-Milliseconds
Window size, always
10000
X-HubSpot-RateLimit-Secondly
Deprecated, ignore
X-HubSpot-RateLimit-Secondly-Remaining
Deprecated, ignore
Header
X-HubSpot-RateLimit-Max
X-HubSpot-RateLimit-Remaining
X-HubSpot-RateLimit-Interval-Milliseconds
X-HubSpot-RateLimit-Secondly
X-HubSpot-RateLimit-Secondly-Remaining
Meaning
Burst ceiling
Calls left in current window
Window size, always
10000
Deprecated, ignore
Deprecated, ignore
Header
Meaning
Inferring app type from Max
Inferring app type from
Max
Max
value
App type
100
Free/Starter private app
110
Public OAuth app (marketplace)
190
Pro/Enterprise private app
250
Private app + API Limit Increase add-on
Max
value
100
110
190
250
App type
Free/Starter private app
Public OAuth app (marketplace)
Pro/Enterprise private app
Private app + API Limit Increase add-on
Max
value
App type
The API Limit Increase add-on does
not
raise the limit for public OAuth apps.
2. Search limit
2. Search limit
Cannot be queried.
No endpoint, no headers (search responses strip them).
Fixed constant:
5 requests per second per portal
. The 10,000-result ceiling per query and 200-records-per-page also apply.
Only confirmable by deliberately triggering a 429:
Copy to clipboard
json
{
"status"
:
"error"
,
"message"
:
"You have reached your secondly limit."
,
"errorType"
:
"RATE_LIMIT"
,
"policyName"
:
"SECONDLY"
}
policyName: "SECONDLY"
from a search endpoint = search bucket. Track this server-side; HubSpot won't help.
3. Daily limit
3. Daily limit
Public OAuth apps: no daily limit
Public OAuth apps:
no daily limit
Skip the daily bucket entirely. OAuth apps are constrained by burst (110/10s) only. Theoretical max sustained = 950,400 calls/day per portal.
Private apps: query the endpoint
Private apps: query the endpoint
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/api-usage/daily/private-apps
Authorization
:
Bearer {portal_access_token}
Returns:
Copy to clipboard
json
{
"results"
:
[
{
"name"
:
"private-apps-api-calls-daily"
,
"usageLimit"
:
1000000
,
"currentUsage"
:
47213
,
"collectedAt"
:
"2026-05-07T11:23:01.362Z"
,
"fetchStatus"
:
"SUCCESS"
,
"resetsAt"
:
"2026-05-08T04:00:00Z"
}
]
}
Field
Meaning
usageLimit
Daily ceiling (shared across ALL private apps in portal)
currentUsage
Today's consumption (private apps only — does not count OAuth calls)
resetsAt
Reset time in UTC, based on portal's configured timezone
Field
usageLimit
currentUsage
resetsAt
Meaning
Daily ceiling (shared across ALL private apps in portal)
Today's consumption (private apps only — does not count OAuth calls)
Reset time in UTC, based on portal's configured timezone
Field
Meaning
Daily limit by tier (private apps)
Daily limit by tier (private apps)
Tier
Daily limit
Free / Starter
250,000
Professional
625,000
Enterprise
1,000,000
Any tier + 1× API Limit Increase
+1,000,000
Any tier + 2× API Limit Increase
+2,000,000 (max)
Tier
Free / Starter
Professional
Enterprise
Any tier + 1× API Limit Increase
Any tier + 2× API Limit Increase
Daily limit
250,000
625,000
1,000,000
+1,000,000
+2,000,000 (max)
Tier
Daily limit
Portal context (timezone, tier)
Portal context (timezone, tier)
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Returns:
Copy to clipboard
json
{
"portalId"
:
123456
,
"accountType"
:
"STANDARD"
,
"timeZone"
:
"Europe/Sofia"
,
"utcOffset"
:
"+03:00"
,
"uiDomain"
:
"app.hubspot.com"
,
"dataHostingLocation"
:
"eu1"
}
Use
timeZone
to interpret
resetsAt
from the daily endpoint.
Cheat sheet: profiling a new portal in Postman
Cheat sheet: profiling a new portal in Postman
Three calls, in order:
GET /account-info/v3/details
→ portal info + read burst headers from response
GET /account-info/v3/api-usage/daily/private-apps
→ daily limits (only meaningful for private apps)
Skip search probing — the 5/sec is fixed
Error response shape
Error response shape
Copy to clipboard
json
{
"status"
:
"error"
,
"message"
:
"You have reached your secondly limit."
,
"errorType"
:
"RATE_LIMIT"
,...
|
Claude
|
Claude
|
NULL
|
4586
|
|
4587
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(
$payload
[
'policyName'
]
??
''
)
?
:
null
;
}
private
function
withJitter
(
int
$seconds
)
:
int
{
// ±20% randomization to prevent thundering-herd retries
$jitter
=
(
int
)
(
$seconds
*
0.2
)
;
return
max
(
1
,
$seconds
+
random_int
(
-
$jitter
,
$jitter
)
)
;
}
Why those defaults
Why those defaults
SECONDLY
→ 2 seconds.
The window is 1 second, so 1.x seconds is enough in theory. 2 with jitter keeps you safely past the boundary even with clock skew.
TEN_SECONDLY_ROLLING
→ 8 seconds.
The window is 10 seconds
rolling
. If you only just barely tipped over (which is the common case if your pre-acquire is roughly correct), the oldest call exits the window in under 10 seconds. 8 + jitter is a reasonable expected value; on the unlucky end you'll still 429 once and back off again.
DAILY
→ 3600 (1 hour) or push to next-day queue.
Don't keep retrying every 10 seconds for the rest of the day — that just burns through your 5% error budget. Better to dead-letter the job until tomorrow morning. (Less relevant for you since OAuth has no daily, but worth handling for completeness.)
Jitter
is non-negotiable. Without it, all your workers that hit the same 429 retry in lockstep and re-create the same 429 wave.
Bonus: log the correlation ID
Bonus: log the correlation ID
You're throwing away a useful debugging signal. The
x-hubspot-correlation-id
from the response (and there's also one in HubSpot's response body for 429s) lets you ask HubSpot support "why did this specific call get rate limited" or correlate with their internal logs if you ever need to escalate. Capture it:
Copy to clipboard
php
$correlationId
=
$this
->
headerValue
(
$headers
,
'x-hubspot-correlation-id'
)
??
(
$payload
[
'correlationId'
]
??
null
)
;
$this
->
log
->
warning
(
'[Hubspot] 429 received'
,
[
'policy'
=>
$policy
,
'retry_after'
=>
$delaySeconds
,
'hubspot_correlation_id'
=>
$correlationId
,
'endpoint'
=>
$endpointForLogging
,
// pass this in
]
)
;
When a customer reports "my sync was slow today" and you can correlate to a flurry of 429s with HubSpot correlation IDs, the diagnosis path is much shorter.
So the final picture
So the final picture
For this codebase, given what HubSpot actually sends:
Pre-acquire from Redis bucket before every call
— this is your primary defense, since post-hoc info is sparse.
On 429, read
policyName
from the body
— the only reliable signal of which bucket fired.
Apply policy-specific backoff with jitter
—
Retry-After
is nice-to-have but rare in practice.
On success, capture
X-HubSpot-RateLimit-*
headers via Guzzle middleware
to clamp the local counter — these
are
present on 200 responses (just confirmed in your earlier Postman screenshot showing
Max=110
).
The asymmetry is the key insight: HubSpot tells you a lot when things are fine, almost nothing when they're not. Your limiter has to be smart enough to work with that.
Copy
Give positive feedback
Give negative feedback
Retry
Scroll to bottom
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Settings
Press and hold to record
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes...
|
Claude
|
Claude
|
NULL
|
4587
|
|
4588
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(
$payload
[
'policyName'
]
??
''
)
?
:
null
;
}
private
function
withJitter
(
int
$seconds
)
:
int
{
// ±20% randomization to prevent thundering-herd retries
$jitter
=
(
int
)
(
$seconds
*
0.2
)
;
return
max
(
1
,
$seconds
+
random_int
(
-
$jitter
,
$jitter
)
)
;
}
Why those defaults
Why those defaults
SECONDLY
→ 2 seconds.
The window is 1 second, so 1.x seconds is enough in theory. 2 with jitter keeps you safely past the boundary even with clock skew.
TEN_SECONDLY_ROLLING
→ 8 seconds.
The window is 10 seconds
rolling
. If you only just barely tipped over (which is the common case if your pre-acquire is roughly correct), the oldest call exits the window in under 10 seconds. 8 + jitter is a reasonable expected value; on the unlucky end you'll still 429 once and back off again.
DAILY
→ 3600 (1 hour) or push to next-day queue.
Don't keep retrying every 10 seconds for the rest of the day — that just burns through your 5% error budget. Better to dead-letter the job until tomorrow morning. (Less relevant for you since OAuth has no daily, but worth handling for completeness.)
Jitter
is non-negotiable. Without it, all your workers that hit the same 429 retry in lockstep and re-create the same 429 wave.
Bonus: log the correlation ID
Bonus: log the correlation ID
You're throwing away a useful debugging signal. The
x-hubspot-correlation-id
from the response (and there's also one in HubSpot's response body for 429s) lets you ask HubSpot support "why did this specific call get rate limited" or correlate with their internal logs if you ever need to escalate. Capture it:
Copy to clipboard
php
$correlationId
=
$this
->
headerValue
(
$headers
,
'x-hubspot-correlation-id'
)
??
(
$payload
[
'correlationId'
]
??
null
)
;
$this
->
log
->
warning
(
'[Hubspot] 429 received'
,
[
'policy'
=>
$policy
,
'retry_after'
=>
$delaySeconds
,
'hubspot_correlation_id'
=>
$correlationId
,
'endpoint'
=>
$endpointForLogging
,
// pass this in
]
)
;
When a customer reports "my sync was slow today" and you can correlate to a flurry of 429s with HubSpot correlation IDs, the diagnosis path is much shorter.
So the final picture
So the final picture
For this codebase, given what HubSpot actually sends:
Pre-acquire from Redis bucket before every call
— this is your primary defense, since post-hoc info is sparse.
On 429, read
policyName
from the body
— the only reliable signal of which bucket fired.
Apply policy-specific backoff with jitter
—
Retry-After
is nice-to-have but rare in practice.
On success, capture
X-HubSpot-RateLimit-*
headers via Guzzle middleware
to clamp the local counter — these
are
present on 200 responses (just confirmed in your earlier Postman screenshot showing
Max=110
).
The asymmetry is the key insight: HubSpot tells you a lot when things are fine, almost nothing when they're not. Your limiter has to be smart enough to work with that.
Copy
Give positive feedback
Give negative feedback
Retry
Scroll to bottom
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Settings
Press and hold to record
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call...
|
Claude
|
Claude
|
NULL
|
4588
|
|
4589
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(...
|
Claude
|
Claude
|
NULL
|
4589
|
|
4590
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the...
|
Claude
|
Claude
|
NULL
|
4590
|
|
4591
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(
$payload
[
'policyName'
]
??
''...
|
Claude
|
Claude
|
NULL
|
4591
|
|
4592
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(
$payload
[
'policyName'
]
??
''
)
?
:
null
;
}
private
function
withJitter
(
int
$seconds
)
:
int
{
// ±20% randomization to prevent thundering-herd retries
$jitter
=
(
int
)
(
$seconds
*
0.2
)
;
return
max
(
1
,
$seconds
+
random_int
(
-
$jitter
,
$jitter
)
)
;
}
Why those defaults
Why those defaults
SECONDLY
→ 2 seconds.
The window is 1 second, so 1.x seconds is enough in theory. 2 with jitter keeps you safely past the boundary even with clock skew.
TEN_SECONDLY_ROLLING
→ 8 seconds.
The window is 10 seconds
rolling
. If you only just barely tipped over (which is the common case if your pre-acquire is roughly correct), the oldest call exits the window in under 10 seconds. 8 + jitter is a reasonable expected value; on the unlucky end you'll still 429 once and back off again.
DAILY
→ 3600 (1 hour) or push to next-day queue.
Don't keep retrying every 10 seconds for the rest of the day — that just burns through your 5% error budget. Better to dead-letter the job until tomorrow morning. (Less relevant for you since OAuth has no daily, but worth handling for completeness.)
Jitter
is non-negotiable. Without it, all your workers that hit the same 429 retry in lockstep and re-create the same 429 wave.
Bonus: log the correlation ID
Bonus: log the correlation ID
You're throwing away a useful debugging signal. The
x-hubspot-correlation-id
from the response (and there's also one in HubSpot's response body for 429s) lets you ask HubSpot support "why did this specific call get rate limited" or correlate with their internal logs if you ever need to escalate. Capture it:
Copy to clipboard
php
$correlationId
=
$this
->
headerValue
(
$headers
,
'x-hubspot-correlation-id'
)
??
(
$payload
[
'correlationId'
]
??
null
)
;
$this
->
log
->
warning
(
'[Hubspot] 429 received'
,
[
'policy'
=>
$policy
,
'retry_after'
=>
$delaySeconds
,
'hubspot_correlation_id'
=>
$correlationId
,
'endpoint'
=>
$endpointForLogging
,
// pass this in
]
)
;
When a customer reports "my sync was slow today" and you can correlate to a flurry of 429s with HubSpot correlation IDs, the diagnosis path is much shorter.
So the final picture
So the final picture
For this codebase, given what HubSpot actually sends:
Pre-acquire from Redis bucket before every call
— this is your primary defense, since post-hoc info is sparse.
On 429, read
policyName
from the body
— the only reliable signal of which bucket fired.
Apply policy-specific backoff with jitter
—
Retry-After
is nice-to-have but rare in practice.
On success, capture
X-HubSpot-RateLimit-*
headers via Guzzle middleware
to clamp the local counter — these
are
present on 200 responses (just confirmed in your earlier Postman screenshot showing
Max=110
).
The asymmetry is the key insight: HubSpot tells you a lot when things are fine, almost nothing when they're not. Your limiter has to be smart enough to work with that.
Copy
Give positive feedback
Give negative feedback
Retry
Scroll to bottom
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Settings
Press and hold to record
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes
Auto-discoverable per portal
Fixed at 5 req/sec, only confirmable via 429
Private apps only — OAuth has no daily limit
Bucket
How to check
Notes
1. Burst limit
1. Burst limit
Make any non-search call and read the
response headers
(not body).
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Headers in response:
Header
Meaning
X-HubSpot-RateLimit-Max
Burst ceiling
X-HubSpot-RateLimit-Remaining
Calls left in current window
X-HubSpot-RateLimit-Interval-Milliseconds
Window size, always
10000
X-HubSpot-RateLimit-Secondly
Deprecated, ignore
X-HubSpot-RateLimit-Secondly-Remaining
Deprecated, ignore
Header
X-HubSpot-RateLimit-Max
X-HubSpot-RateLimit-Remaining
X-HubSpot-RateLimit-Interval-Milliseconds
X-HubSpot-RateLimit-Secondly
X-HubSpot-RateLimit-Secondly-Remaining
Meaning...
|
Claude
|
Claude
|
NULL
|
4592
|
|
4593
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(
$payload
[
'policyName'
]
??
''
)
?
:
null
;
}
private
function
withJitter
(
int
$seconds
)
:
int
{
// ±20% randomization to prevent thundering-herd retries
$jitter
=
(
int
)
(
$seconds
*
0.2
)
;
return
max
(
1
,
$seconds
+
random_int
(
-
$jitter
,
$jitter
)
)
;
}
Why those defaults
Why those defaults
SECONDLY
→ 2 seconds.
The window is 1 second, so 1.x seconds is enough in theory. 2 with jitter keeps you safely past the boundary even with clock skew.
TEN_SECONDLY_ROLLING
→ 8 seconds.
The window is 10 seconds
rolling
. If you only just barely tipped over (which is the common case if your pre-acquire is roughly correct), the oldest call exits the window in under 10 seconds. 8 + jitter is a reasonable expected value; on the unlucky end you'll still 429 once and back off again.
DAILY
→ 3600 (1 hour) or push to next-day queue.
Don't keep retrying every 10 seconds for the rest of the day — that just burns through your 5% error budget. Better to dead-letter the job until tomorrow morning. (Less relevant for you since OAuth has no daily, but worth handling for completeness.)
Jitter
is non-negotiable. Without it, all your workers that hit the same 429 retry in lockstep and re-create the same 429 wave.
Bonus: log the correlation ID
Bonus: log the correlation ID
You're throwing away a useful debugging signal. The
x-hubspot-correlation-id
from the response (and there's also one in HubSpot's response body for 429s) lets you ask HubSpot support "why did this specific call get rate limited" or correlate with their internal logs if you ever need to escalate. Capture it:
Copy to clipboard
php
$correlationId...
|
Claude
|
Claude
|
NULL
|
4593
|
|
4594
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', [pol1cv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter — these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asy mmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work with*x Hubspot• SearchYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaboration.POST search de • POST Readabal • POST Read a bat •GET ReadGET ReadGET read call•GET Get Engage•teration run Search HS (#7)u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:21 (1 min) • Fixed profileSummaryTotal requests sent ©Requests/second ©Avg. response time ©6.550109.04155 ms% 100P90 ©173 msp95 O196 ms"Lukas sterka 121• In 1omGET Read CopyGET https://api.tIteration run HSPOST search contaPOST search conta© Iteration run Se100% L2Thu 7 May 17:12:37UparadeIteration run SeNo environmentWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engagemente old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely toa Connect Git = Concole 5.l TermP99 ©287 msError % ©0,00Failure % ©0,00Peak CPU % ©100.0 %Peak Memory % ©195 %Filter bv requestsvAvg. response262 ms 140 req/s25017•08.25|17-08-21Dorformonso dotolle fortotol durotinnPOST search contact by email Copy17•08•2717•08•4617•08•496,550108.480.0017:08:55Falture %0.0017•09•01Resp. time (Ava. ms)17:09:0717.09-1217.09-19- Requests/second - Ava. response - Error % - Virtual users ..• CPU % ..• Memory %Min (ms)Max (ms)693287Globals Vault Tools s 000...
|
iTerm2
|
NULL
|
NULL
|
4594
|
|
4595
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screnshot showing Max=110).The asvmmetry is the kev insight: HubSpot tells vou a lot when things are fine.almost nothing when they're not. Your limiter has to be smart enough to work withunan*x Hubspot• SearchYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaboration.POST search de • POST Readabal • POST Reada bat eGET ReadGET ReadGET read call•GET Get Engage•teration run Search HS (#7)u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:21 (1 min) • Fixed profileSummaryTotal requests sent ©Requests/second ©Avg. response time ©6.550109.04155 ms% 100P90 ©173 msp95 O196 ms"Lukas sterka 121• In 1omGET Read CopyGET https://api.tIteration run HSPOST search contaPOST search conta© Iteration run Se100% L2Thu 7 May 17:12:40UparadeIteration run SeNo environmentWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotlteration run HSGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engagemente old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E TerrP99 ©287 msError % ©0,00Failure % ©0,00Peak CPU % ©100.0 %Peak Memory % ©195 %Filter bv requestsvAvg. response262 ms 140 req/s25017•08.25|17-08-21Dorformonso dotolle fortotol durotinnPOST search contact by email Copy17•08•2717•08•4617•08•496,550108.480.0017:08:55Falture %0.0017•09•01Resp. time (Ava. ms)17:09:0717.09-1217.09-19- Requests/second - Ava. response - Error % - Virtual users ..• CPU % ••• Memory %Min (ms)Max (ms)693287Globals Vault Tools 5000...
|
iTerm2
|
NULL
|
NULL
|
4595
|
|
4596
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate Wititheir internal logs if you ever need to escalate. Capture it:f Lukas/Stefka 121 • in 18 m100% C/)Thu 7 May 17:12:44*x HubspotQ SearchYour team is now on the Free olan with 1 admin. You retain editina access and other members are read-onlv. View team nermissions to see who can edit or unarade to restore collaborationGET ReadGET ReadGET read callGET Get Engageteration run Search HS (#7)u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:21 (1 min) • Fixed profileTesfgm lteration run HmIteration run SD Iteration run Selscorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanFailure Trend Tests vs VUThis run has no test assertionsAdd test scriots to vour requests to see test results hereWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesustem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E TerGlobals Vault Tools s 000...
|
iTerm2
|
NULL
|
NULL
|
4596
|
|
4597
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelp(ahlLukas/Stefka 121 • in 18 m100% <478Thu 7 May 17:12:44DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4597
|
|
4598
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelp(ahlLukas/Stefka 121 • in 18 m100% <478Thu 7 May 17:12:47DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4598
|
|
4599
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate Wititheir internal logs if you ever need to escalate. Capture it:f Lukas/Stefka 121 • in 18 m100% L2Thu 7 May 17:12:47*x HubspotQ SearchYour team is now on the Free olan with 1 admin. You retain editina access and other members are read-onlv. View team nermissions to see who can edit or unarade to restore collaborationGET ReadGET ReadGET read callGET Get Engagem lteration run HmIteration run SD Iteration run Selteration run Search HS (#7)u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:21 (1 min) • Fixed profilescorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesustem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E TerThis run has no errorsAll requests were sent successfully and returned a 2xx response code.Globals Vault Tools S 0 0 0...
|
iTerm2
|
NULL
|
NULL
|
4599
|
|
4600
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate Wititheir internal logs if you ever need to escalate. Capture it:"Lukas sterka 121 • In 10m100% L2Thu 7 May 17:12:52*x Hubspot• SearchYour team is now on the Free olan with 1 admin. You retain editina access and other members are read-onlv. View team nermissions to see who can edit or unarade to restore collaborationGET ReadGET ReadGET read callGET Get Enoagem lteration run HmIteration run SE Iteration ruscorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesustem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E Terteration run Search HS (#7)u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:21 (1 min) • Fixed profileSummaryThis run has no errorsAll requests were sent successfully and returned a 2xx response code.Globals Vault Tools S 0 0 0...
|
iTerm2
|
NULL
|
NULL
|
4600
|
|
4601
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelp(ahlLukas/Stefka 121 • in 18 m100% <478Thu 7 May 17:12:52DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4601
|
|
4602
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why dia this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:*x HubspotYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaboration• SearchGET read callGET Get Engagem. •• Iteration run HSIteration run Search HSOverview Authorization • Scriots Variables"Lukas sterka 121• In 1om100% L2Thu 7 May 17:12:56UparadeE Iteration run SeaNo environment( Publish docs Run8|0scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv lteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4> OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E TermIteration run Search HSỞ You & 1 all1 D 03:56 PM, May 07, 2026Help people understand your collection by adding a description. 4* Write with AllGlobals Vault Tools? 0 00...
|
iTerm2
|
NULL
|
NULL
|
4602
|
|
4603
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelp(ahlLukas/Stefka 121 • in 18 m100% [8Thu 7 May 17:12:56DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4603
|
|
4604
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why dia this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanSO N O"Lukas sterka 121 • In 1/m100% L2Thu 7 May 17:13:01*x HubspotYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaborationPOST search deaIteration run Search HSOverview Authorization ScriotsVariables RunsFunctionalScheduledPerformanceRuns triagered for this collection via Collection Runner and Postman CILI.Last 100 runs vRun by vRun statusvSource vSourceMay 07, 2026 03:21:13RunnerMay 07. 2026 03:20:15RunnerMay 07. 2026 03:16:38Runne• SearchGET read callGET Get Engagem. •• Iteration run HSPOST search contadE Iteration run SeaNo environment( Publish docs Run8|0•|0Write a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotvteration run HSGET Read Copyeg. An error occurred.successful operationv lteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4> OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesustem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E TermDuration3s 287ms3s 500ms4s 190msAll testsFailedAvg. Resp. Timd221 ms218 ms27 ms...
|
iTerm2
|
NULL
|
NULL
|
4604
|
|
4605
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelpla6lLukas/Stefka 121 - in 17 m100% [8Thu 7 May 17:13:02DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4605
|
|
4606
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why dia this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanf Lukas/Stefka 121 • in 17 m100% s2Thu 7 May 17:13:03Write a message.Opus 4. Adaptive*x Hubspot• SearchYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaborationV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotvteration run HSGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningPOST Read a bat •GET ReadGET ReadGET read call •GET Get Engage•Iteration run Search HS - Run resultsỞ Ran today at 03:21:13 PM • View all runsSourceDurationAll testsAvg. Resp. TimeRunne3s 287ms221 msAll 0 Passed 0 Failed 0skippedo errors o console logPosT search contact by email CopyNo tests foundIteration 2POST search contact bv email ConvNo tects foundIteration 3post search contact by emall copyNo tests foundPOST search contact by email CopyNo tests foundPOST search contact by email CopyNo tests foundPosT search contact by email CopyNo tests foundpoSt search contact bv email ConvNo tests foundSustem resources are constrained. Thesustem may not be able to generate the loadneeded for this test and the cest is likely topoct cearch contact by email Copy§ Connect Git E Console E Ter0 lteration run HPOST search contamIteration run S• Run AgainIteration run S,Automate RunvShareGrid200 • 228 ms • 1.23 KB200 • 232 ms • 1.228 KB200 • 2111 ms • 1.228 KB200 • 198 ms • 1.23 KB200 • 211 ms • 1.228 KB200 • 196 ms • 1.23 KB200 • 238 ms • 1.222 KB200 • 213 ms • 1.224 KB...
|
iTerm2
|
NULL
|
NULL
|
4606
|
|
4607
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why dia this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanSO N Of Lukas/Stefka 121 • in 17 mWrite a message.Opus 4. Adaptive*x Hubspot• SearchYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaborationV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotvteration run HSGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningPOST Read a bat•GET ReadGET ReadGET read call•GET Get Engage•Iteration run Search HS - Run resultsỞ Ran today at 03:21:13 PM • View all runsDurationAll testsAvg. Resp. TimeRunne3s 287ms221 msAll o Passed 0 Failed oSkipped 0 Errors 0 Console logNo tests toundPOST search contact by email CopyNo tests foundorstonpost search contact by emall copyNo tocts foundIteration 6POST search contact by email CopyNo tests foundPOST search contact by email CopyPOST search contact by email CopyNo tocte foundPOST search contact bv email Coovhttps://api.hubapi.com/crm/v3/objects/contacts/searchSustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely toPOST search contegt by email CopyNo tests found§ Connect Git E Console E Ter0 lteration run HmIteration run S• Run Again100% C4)Thu 7 May 17:13:12UparadeIteration run S,Automate RunvShare...200 • 198 ms • 1.23 KB200 • 211 ms • 1.228 KB200 • 196 ms • 1.23 KB(200 • 238 ms • 1.222 KB200 • 205 ms • 1.226 KB200 • 279 ms • 1.23 KB...
|
iTerm2
|
NULL
|
NULL
|
4607
|
|
4608
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelpla6lLukas/Stefka 121 - in 17 m100% <478Thu 7 May 17:13:12• 0DOCKER→- 81DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T81-zsh• 84screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4608
|
|
4609
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate Wititheir internal logs if you ever need to escalate. Capture it:SO N O"Lukas sterka 121 • In 1/m100% L2Inu / May 1/:13-14Uparade*x Hubspot• SearchYour team is now on the Free olan with 1 admin. You retain editina access and other members are read-onlv. View team nermissions to see who can edit or unarade to restore collaborationGET next offs. • POST search dPoST Readab. • POST Readab,GET ReadGET ReadGET read cal •GET Get EnoacGET Read CopyGET httos:/lapiOIteration run t POST search cont POST search conlIteration run sNo environment v |x=scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["policv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter - these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withunanWrite a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv lteration run Search HSpost search contact by email Copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesustem may not be able to generate the loadeded for this test and the cest is likely to§ Connect Git E Console E Term...
|
iTerm2
|
NULL
|
NULL
|
4609
|
|
4610
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', [pol1cv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter — these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withWrite a message.Opus 4. Adaptive*x HubspotYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaboration.V COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotlteration run HSGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningPOST Readab,GET Read •GET Read •GET read cal •GET Get Engag•Iteration run Search HS - Run results• Ran today at 03:21:13 PM • View alllnunsDurationAll testsAvg. Resp. TimeRunne3s 287ms221 msAll o Passed 0 Failed oSkipped 0 Errors 0 Console logNo tests toundPOST search contact by email CopyNo tests foundorstonpost search contact by emall copyNo tests foundIteration 6POST search contact by email CopyNo tests foundPOST search contact by email CopyNo tects foundPOST search contact by email CopyNo tocte foundPOST search contact bv email Coovhttps://api.hubapi.com/crm/v3/objects/contacts/searchNo tests foundPOST search contact by email CopySustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely toNo tests found§ Connect Git E Console E TerGET Read CopyGET httos:llapilm lteration runSO N Of Lukas/Stefka 121 • in 17 mIteration run s• Run Again100% C4)Thu 7 May 17:13:20UparadeNo environmentvAutomate RunvShare...200 • 211 ms • 1.228 KB200 • 205 ms • 1.226 KB...
|
iTerm2
|
NULL
|
NULL
|
4610
|
|
4611
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelpla6lLukas/Stefka 121 - in 17 m100% [8Thu 7 May 17:13:20DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4611
|
|
4612
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelpla6lLukas/Stefka 121 - in 17 m100% <478Thu 7 May 17:13:23DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4612
|
|
4613
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', [pol1cv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter — these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work withWrite a message.Opus 4. Adaptive*x HubspotYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaboration.V COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotlteration run HSGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningPOST Read ab.POST Readab,GET Read •GET Read •GET read cal •GET Get Engag•Iteration run Search HS - Run resultsÔ Ran today at 03:21:13 PM • View all gunsDurationAll testsAvg. Resp. TimeRunne3s 287ms221 msAll o Passed 0 Failed oSkipped 0 Errors 0 Console logNo tests toundPOST search contact by email CopyNo tests foundorstonpost search contact by emall copyNo tests foundIteration 6POST search contact by email CopyNo tests foundPOST search contact by email CopyNo tects foundPOST search contact by email CopyNo tocte foundPOST search contact bv email Coovhttps://api.hubapi.com/crm/v3/objects/contacts/searchNo tests foundPOST search contact by email CopySustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely toNo tests found§ Connect Git E Console E TerGET Read CopyGET httos:llapim lteration runf Lukas/Stefka 121 • in 17 m100% C4)Iteration run s• Run AgainThu 7 May 17:13:24UparadeNo environmentvAutomate RunvShare...List200 • 211 ms • 1.228 KB200 • 198 ms • 1.23 KB200 • 211 ms • 1.228 KB(200 • 238 ms • 1.222 KB200 • 205 ms • 1.226 KB...
|
iTerm2
|
NULL
|
NULL
|
4613
|
|
4614
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why dia this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', [pol1cv"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter — these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work with"Lukas sterka 121 • In 1/m100% L2Inu / May 1/:13•20*x HubspotYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaborationPOST ReadalIteration run Search HSOverview Authorization oScripts VariablesFunctionalScheduledPerformanceRuns triagered for this collection via Collection Runner and Postman CILI.Last 100 runs vRun by vRun status vSource vSourceMay 07, 2026 03:21:13RunnerMay 07. 2026 03:20:15RunnerMay 07. 2026 03:16:38Runne• SearchGET Get Enga•GET Read CopyGET httos:llarC Iteration runPOST search corO Iteration runD Iteration runPOST search co0 Iteration runNo environment( Publish docs Run8|0Write a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv lteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4> OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engagemonte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesustem may not be able to generate the loadeded for this test and the cest is likely to§ Connect Git E Console E Term0| 0Duration3s 287ms3s 560ms4s 190msAll testsPassedFailedSkippedAvg. Kesp. Time221 ms218 ms27 ms...
|
iTerm2
|
NULL
|
NULL
|
4614
|
|
4615
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelpla6lLukas/Stefka 121 - in 17 m100% [8Thu 7 May 17:13:26DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•$5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4615
|
|
4616
|
iTerm2ShellEditViewSessionScriptsProfilesWindowHel iTerm2ShellEditViewSessionScriptsProfilesWindowHelpla6lLukas/Stefka 121 - in 17 m100% [8Thu 7 May 17:13:33DOCKERO ₴1DEV (docker)182Matching contact 4Matching contact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0Matching contact 1Matching contact 2Matching contact 3Matching contact 4Matchingcontact 5Matching contact 6Matching contact 7Matching contact 8Matching contact 9root@docker_lamp_1:/home/jiminny# php artisan jiminny:debugMatching contact 0APP (-zsh)DEV (docker)*3T₴1-zsh• 84|screenpipe*•₴5Jiminny \Exceptions \RateLimitExceptionHubspot returned 429at app/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:206202'retry_after' =SretryAfter,203"reason'204= Se->getMessage(),205→ 206throw new RateLimitException('Hubspot returned 429', SretryAfter, $e);207208} else 1throw $e;209}210+14 vendor frames15-zsh₴6DEVapp/Services/Crm/Hubspot/Pagination/HubspotPaginationService.php:166SevenShores\Hubspot\Http\Client:: request("POST", "[URL_WITH_CREDENTIALS]...
|
iTerm2
|
NULL
|
NULL
|
4616
|
|
4617
|
PostmancaltVIewWindowmelpHubSpot rate limit implem PostmancaltVIewWindowmelpHubSpot rate limit implementation strategy vfrom the response (and there's also one in HubSpot's response body for 429s) letsyou ask Hudspot support "why did this specine call get rate limited" or correlate wititheir internal logs if you ever need to escalate. Capture it:scorrelationid = sthis->headerValue(Sheaders, 'x-hubspot-correlation-id')?? ($payload['correlationId'] ?? null);$this->log->warning('[Hubspot] 429 received', ["pol1cV"= $policy,'retry_after'=> sdelayseconds,'hubspot_correlation_id''endpoint'→> $correlationId,=> $endpointForLogging, // pass this in]);When a customer reports "my sync was slow today" and you can correlate to a flurryof 429s with HubSpot correlation IDs, the diagnosis path is much shorter.So the final pictureFor this codebase, given what HubSpot actually sends:1. Pre-acquire from Redis bucket before every call — this is your primary defensesince post-hoc info is sparse.2. On 429, read policyName from the body — the only reliable signal of whichbucker hired.3. Apply policy-specific backoff with jitter - Retry-After is nice-to-have butrare in practice.4. On success, capture X-HubSpot-RateLimit-* headers via Guzzle middlewareto clamp the local counter — these are present on 200 responses (just confirmedin your earlier Postman screenshot showing Max=110 ).The asymmetry is the key insight: HubSpot tells you a lot when things are fine,almost nothing when they're not. Your limiter has to be smart enough to work with50 lil"Lukas sterka 121• In 1/m100% L2Inu / May 1/-13.34*x Hubspot• SearchUparadeYour team is now on the Free plan with 1 admin. You retain editing access and other members are read-only. View team permissions to see who can edit, or upgrade to restore collaboration.POST search • POST Reada • POST Reada •GET ReadGET Read •GET read ci"GET Get Eng •GET Read CopsGET https://e•Iteration rurPOST search ccPOST search cIteration rurIteration rurPOST search ccIteration rurIteration rurNo environmentteration run Search HS (#7)u Iteration run Search HS • 20 VUs • May 07, 2026 17:08:24 (1 min) • Fixed profileSummaryTotal requests sent ©6.550Requests/second ©Avg. response time C109.04155 msP90 O173 msP9 ©196 msP99 ©287 msError % ©0,00Failure % ©0,00Filter by requestsAva. response% 100262 ms 140 req/s250Write a message.Opus 4. AdaptiveV COLLECTIONS> CRM Owners› CRM Pipelines› Dealsengagements>D OLD ENGAGEMENTSuer list meetingsPOST search modified companiesGET read call> POST search callsGET ist callsPOST meetings scheduledGET det meetingPost get link to task>POST Create Contact with Association› Hubspotv teration run HsGET Read Copyeg. An error occurred.successful operationv Iteration run Search HSpost search contact oy emall copy> Journal & webhoooks v4› OAuth› Properties> RESEARCHSEARCHIPoSt search contact by phonePOST search contact by emailPOST search meetings> PoST Search calls v3POST Search related meetinas v3Post search deals> Ticketsv UicofullGET engageronte old accociated hu dealSustem Resource WarningSustem resources are constrained. Thesystem may not be able to generate the loadneeded for this test and the cest is likely to§ Connect Git E Console E Ter17•08.25|17-08-21Dorformonso dotolle fortotol durotinnPOST search contact by email Copy17•08•2717•08•4617•08•496,550109.040.0017:08:55Falture %0.0017•09•01Resp. time (Ava. ms)17:09:07Min (ms)17.09-1217.09-19- Requests/second - Ava. response — Error %Max (ms)693287Globals Vault Tools s 000...
|
iTerm2
|
NULL
|
NULL
|
4617
|
|
4618
|
Skip to content
Skip to content
Click to collapse
Skip to content
Skip to content
Click to collapse
⌘B
Drag to resize
Open sidebar
Chat
Cowork
Code
New chat ⌘N
New chat
⌘N
Projects
Artifacts
Customize
Pinned
Bulgarian citizenship application process for EU residents
More options for Bulgarian citizenship application process for EU residents
Dawarich location tracking project
More options for Dawarich location tracking project
Recents
View all
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Screenpipe retention policy code location
More options for Screenpipe retention policy code location
Viewing retention policy in screenpipe
More options for Viewing retention policy in screenpipe
Clean shot x video recording termination issue
More options for Clean shot x video recording termination issue
HubSpot rate limit handling with executeRequest
More options for HubSpot rate limit handling with executeRequest
Untitled
More options
💬 Screen pipe. Is there ability…
More options for 💬 Screen pipe. Is there ability…
SMB mount access inconsistency between Finder and iTerm
More options for SMB mount access inconsistency between Finder and iTerm
💬 What is the best switch I can…
More options for 💬 What is the best switch I can…
Permission denied on screenpipe volume
More options for Permission denied on screenpipe volume
Screenpipe sync database attachment error
More options for Screenpipe sync database attachment error
Last swimming outing with Dani
More options for Last swimming outing with Dani
Definition of incarcerated
More options for Definition of incarcerated
Chromecast remote volume buttons not working
More options for Chromecast remote volume buttons not working
Salesforce API errors with Organization and FieldDefinition queries
More options for Salesforce API errors with Organization and FieldDefinition queries
Daily activity summary from screenpipe data
More options for Daily activity summary from screenpipe data
MacBook unexpected restarts and kanji screen
More options for MacBook unexpected restarts and kanji screen
Security patch review and testing guidance
More options for Security patch review and testing guidance
Food calorie values reference
More options for Food calorie values reference
Tracking location history from last week
More options for Tracking location history from last week
Lukas Pro
Get apps and extensions
HubSpot rate limit implementation strategy, rename chat
HubSpot rate limit implementation strategy
More options for HubSpot rate limit implementation strategy
Share chat
Claude finished the response
[2026-05-07 14:08:35] local.INFO: [Hubspot] DEBUG Getting headers {"headers":{"Date":["Thu, 07 May 2026 14:08:35 GMT"],"Content-Type":["application/json;charset=utf-8"],"Content-Length":["227"],"Connection":["keep-alive"],"CF-Ray":["9f80cc29fd66dc1a-SOF"],"CF-Cache-Status":["DYNAMIC"],"Strict-Transport-Security":["max-age=31536000; includeSubDomains; preload"],"Vary":["origin"],"access-control-allow-credentials":["false"],"server-timing":["hcid;desc=\"019e02c4-d684-7f5d-be16-3d129d00c0a3\", cfr;desc=\"9f80cc2a06d23402-IAD\""],"x-content-type-options":["nosniff"],"x-hubspot-correlation-id":["019e02c4-d684-7f5d-be16-3d129d00c0a3"],"Set-Cookie":["__cf_bm=0LMCTstVmP5pyIYfLZ1Vgebevm4BnI_hv250XvZJDZI-1778162915-[IP_ADDRESS]-VEXAxU7TqgaJhUSJaNRDF5y59Eo7wOLd78Bm1nV_hNpBHZQPCrg.WMJL_LJy2qoR84rCgLXAlUPz4jkFWtD3fDjrRxypSlr4zAPvuPPaoNM; path=/; expires=Thu, 07-May-26 14:38:35 GMT; domain=.hubapi.com; HttpOnly; Secure; SameSite=None"],"Report-To":["{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=4wbdllfukF%2BA1EOwyTeqZCIqvY2KcW%2BCX5f%2BaZsnWkxc6ccKufGimFrCvj%2FnyWTDpsdCMXE0ngrpMA7WjiyvJDXtlDtN2YAhtK127%2FDtKe1JCyjgKsMQXBSMhBDyTC7c\"}],\"group\":\"cf-nel\",\"max_age\":604800}"],"NEL":["{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}"],"Server":["cloudflare"]}} {"correlation_id":"d326aafa-339a-42c1-bf53-05ebd7f52782","trace_id":"19b29b52-6663-4853-8096-e32bf6618df7"}
Show more
17:10
Retry
Edit
Copy
Previous version
2 / 2
Next version
Claude responded: That confirms the diagnosis.
Claude responded: That confirms the diagnosis.
Confirmed absence of retry headers; policy-based fallback necessary
Confirmed absence of retry headers; policy-based fallback necessary
That confirms the diagnosis. Look at what's there and — more importantly — what isn't:
Missing from the 429 response:
❌
Retry-After
❌
X-HubSpot-RateLimit-Max
❌
X-HubSpot-RateLimit-Remaining
❌
X-HubSpot-RateLimit-Interval-Milliseconds
Present that's actually useful:
✅
x-hubspot-correlation-id
(for debugging / filing tickets with HubSpot)
So HubSpot is giving you essentially no telemetry on this 429. No retry hint, no remaining-budget signal. The fact that even the regular rate-limit headers are absent strongly suggests this was the
search
429 (the
/contact/search
one) — search responses always strip rate-limit headers, error or not.
What this means
What this means
Your
parseRetryAfter()
cannot rely on
Retry-After
from HubSpot.
The policy-based fallback is the actual primary path
, not a fallback. The header lookup is dead code that's there in case HubSpot ever changes — fine to keep, but understand it'll basically never fire.
So flip the framing of your function: the policy-based logic is the main behavior, header lookup is opportunistic.
Copy to clipboard
php
public
function
parseRetryAfter
(
Throwable
$e
)
:
int
{
// Opportunistic: HubSpot rarely sends Retry-After, but use it if present
$headers
=
$this
->
extractHeaders
(
$e
)
;
$retryAfter
=
$this
->
headerValue
(
$headers
,
'Retry-After'
)
;
if
(
is_numeric
(
$retryAfter
)
)
{
return
$this
->
withJitter
(
max
(
1
,
(
int
)
$retryAfter
)
)
;
}
// Primary path: derive from policyName in response body
$policy
=
$this
->
extractPolicy
(
$e
)
;
return
$this
->
withJitter
(
match
(
$policy
)
{
'SECONDLY'
=>
2
,
'TEN_SECONDLY_ROLLING'
=>
8
,
'DAILY'
=>
3600
,
default
=>
5
,
}
)
;
}
private
function
extractPolicy
(
Throwable
$e
)
:
?
string
{
$body
=
$this
->
extractBody
(
$e
)
;
$payload
=
json_decode
(
$body
,
true
)
?
:
[
]
;
return
strtoupper
(
$payload
[
'policyName'
]
??
''
)
?
:
null
;
}
private
function
withJitter
(
int
$seconds
)
:
int
{
// ±20% randomization to prevent thundering-herd retries
$jitter
=
(
int
)
(
$seconds
*
0.2
)
;
return
max
(
1
,
$seconds
+
random_int
(
-
$jitter
,
$jitter
)
)
;
}
Why those defaults
Why those defaults
SECONDLY
→ 2 seconds.
The window is 1 second, so 1.x seconds is enough in theory. 2 with jitter keeps you safely past the boundary even with clock skew.
TEN_SECONDLY_ROLLING
→ 8 seconds.
The window is 10 seconds
rolling
. If you only just barely tipped over (which is the common case if your pre-acquire is roughly correct), the oldest call exits the window in under 10 seconds. 8 + jitter is a reasonable expected value; on the unlucky end you'll still 429 once and back off again.
DAILY
→ 3600 (1 hour) or push to next-day queue.
Don't keep retrying every 10 seconds for the rest of the day — that just burns through your 5% error budget. Better to dead-letter the job until tomorrow morning. (Less relevant for you since OAuth has no daily, but worth handling for completeness.)
Jitter
is non-negotiable. Without it, all your workers that hit the same 429 retry in lockstep and re-create the same 429 wave.
Bonus: log the correlation ID
Bonus: log the correlation ID
You're throwing away a useful debugging signal. The
x-hubspot-correlation-id
from the response (and there's also one in HubSpot's response body for 429s) lets you ask HubSpot support "why did this specific call get rate limited" or correlate with their internal logs if you ever need to escalate. Capture it:
Copy to clipboard
php
$correlationId
=
$this
->
headerValue
(
$headers
,
'x-hubspot-correlation-id'
)
??
(
$payload
[
'correlationId'
]
??
null
)
;
$this
->
log
->
warning
(
'[Hubspot] 429 received'
,
[
'policy'
=>
$policy
,
'retry_after'
=>
$delaySeconds
,
'hubspot_correlation_id'
=>
$correlationId
,
'endpoint'
=>
$endpointForLogging
,
// pass this in
]
)
;
When a customer reports "my sync was slow today" and you can correlate to a flurry of 429s with HubSpot correlation IDs, the diagnosis path is much shorter.
So the final picture
So the final picture
For this codebase, given what HubSpot actually sends:
Pre-acquire from Redis bucket before every call
— this is your primary defense, since post-hoc info is sparse.
On 429, read
policyName
from the body
— the only reliable signal of which bucket fired.
Apply policy-specific backoff with jitter
—
Retry-After
is nice-to-have but rare in practice.
On success, capture
X-HubSpot-RateLimit-*
headers via Guzzle middleware
to clamp the local counter — these
are
present on 200 responses (just confirmed in your earlier Postman screenshot showing
Max=110
).
The asymmetry is the key insight: HubSpot tells you a lot when things are fine, almost nothing when they're not. Your limiter has to be smart enough to work with that.
Copy
Give positive feedback
Give negative feedback
Retry
Write a message…
Write a message…
Add files, connectors, and more
Model: Opus 4.7 Adaptive
Opus 4.7
Adaptive
Settings
Press and hold to record
Claude is AI and can make mistakes. Please double-check responses.
Claude is AI and can make mistakes. Please double-check responses.
Preview
Code
Hubspot rate limits reference · MD
Hubspot rate limits reference
·
MD
Copy
Go back
HubSpot Rate Limit Reference
HubSpot Rate Limit Reference
Quick reference for checking what rate limits apply to a portal.
Three buckets, three discovery methods
Three buckets, three discovery methods
Bucket
How to check
Notes
Burst
Response headers on any non-search call
Auto-discoverable per portal
Search
Not queryable
Fixed at 5 req/sec, only confirmable via 429
Daily
/account-info/v3/api-usage/daily/private-apps
Private apps only — OAuth has no daily limit
Bucket
Burst
Search
Daily
How to check
Response headers on any non-search call
Not queryable
/account-info/v3/api-usage/daily/private-apps
Notes
Auto-discoverable per portal
Fixed at 5 req/sec, only confirmable via 429
Private apps only — OAuth has no daily limit
Bucket
How to check
Notes
1. Burst limit
1. Burst limit
Make any non-search call and read the
response headers
(not body).
Copy to clipboard
http
GET https://api.hubapi.com/account-info/v3/details
Authorization
:
Bearer {portal_access_token}
Headers in response:
Header
Meaning
X-HubSpot-RateLimit-Max
Burst ceiling
X-HubSpot-RateLimit-Remaining
Calls left in current window
X-HubSpot-RateLimit-Interval-Milliseconds
Window size, always
10000
X-HubSpot-RateLimit-Secondly
Deprecated, ignore
X-HubSpot-RateLimit-Secondly-Remaining...
|
Claude
|
Claude
|
NULL
|
4618
|