hubspot-load-scale

# HubSpot Load & Scale ## Overview Load testing and capacity planning for HubSpot integrations, constrained by the 10 requests/second and 500,000 requests/day API limits. ## Prerequisites - k6 or similar load testing tool - HubSpot developer test account (never load test against production) - Understanding of HubSpot rate limits ## Instructions ### Step 1: Understand HubSpot Rate Limit Constraints Your integration's maximum throughput is bound by HubSpot's limits: | Constraint | Limit | Impact | |-----------|-------|--------| | Per-second | 10 req/sec | 600 req/min maximum | | Daily | 500,000/day | ~347 req/min sustained | | Batch size | 100 records/batch | Each batch = 1 API call | | Search results | 10,000 total | Cannot page past 10K | | Associations | 500 per record | Hard limit | **Effective throughput with batching:** - Individual operations: 10 records/sec - Batch operations: 1,000 records/sec (10 batches/sec x 100 records/batch) ### Step 2: k6 Load Test Script ```javascript // hubspot-load-test.js import http from 'k6/http'; import { check, sleep } from 'k6'; import { Rate, Trend } from 'k6/metrics'; const errorRate = new Rate('hubspot_errors'); const rateLimited = new Rate('hubspot_rate_limited'); export const options = { stages: [ { duration: '1m', target: 2 }, // warm up (2 req/sec) { duration: '3m', target: 5 }, // moderate load { duration: '2m', target: 8 }, // approach limit { duration: '2m', target: 10 }, // at limit ...