hubspot-performance-tuning

# HubSpot Performance Tuning ## Overview Optimize HubSpot API performance through batch operations, caching, search optimization, and request minimization. ## Prerequisites - `@hubspot/api-client` installed - Understanding of your access patterns (read-heavy vs write-heavy) - Optional: Redis for distributed caching ## Instructions ### Step 1: Use Batch APIs Everywhere The single biggest performance win: batch operations reduce API calls by up to 100x. ```typescript import * as hubspot from '@hubspot/api-client'; const client = new hubspot.Client({ accessToken: process.env.HUBSPOT_ACCESS_TOKEN!, numberOfApiCallRetries: 3, }); // BAD: 100 API calls for 100 contacts async function getContactsSlow(ids: string[]) { return Promise.all(ids.map(id => client.crm.contacts.basicApi.getById(id, ['email', 'firstname']) )); } // GOOD: 1 API call for 100 contacts async function getContactsFast(ids: string[], properties: string[]) { // POST /crm/v3/objects/contacts/batch/read const result = await client.crm.contacts.batchApi.read({ inputs: ids.map(id => ({ id })), properties, propertiesWithHistory: [], }); return result.results; } // For more than 100 records, chunk: async function getContactsChunked(ids: string[], properties: string[]) { const results = []; for (let i = 0; i < ids.length; i += 100) { const chunk = ids.slice(i, i + 100); const batch = await getContactsFast(chunk, properties); results.push(...batch); } return res...