hubspot-common-errors

# HubSpot Common Errors ## Overview Quick reference for the most common HubSpot API errors, their real error response bodies, and solutions. ## Prerequisites - `@hubspot/api-client` installed - API credentials configured - Access to application logs ## Instructions ### Step 1: Identify the Error Check the HTTP status code and response body. HubSpot returns structured errors: ```json { "status": "error", "message": "One or more validation errors occurred", "correlationId": "abc123-def456", "category": "VALIDATION_ERROR", "errors": [ { "message": "Property values were not valid: [{\"isValid\":false,\"message\":\"...\"}]", "context": { "propertyName": "email" } } ] } ``` ### Step 2: Match and Fix --- ### 401 Unauthorized **Real response:** ```json { "status": "error", "message": "Authentication credentials not found. This API supports OAuth 2.0 authentication and you can find more details at https://developers.hubspot.com/docs/methods/auth/oauth-overview", "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "category": "INVALID_AUTHENTICATION" } ``` **Causes:** - Missing `Authorization: Bearer` header - Expired OAuth access token (30-minute TTL) - Revoked or regenerated private app token **Fix:** ```bash # Verify token is set and valid curl -s https://api.hubapi.com/crm/v3/objects/contacts?limit=1 \ -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" | jq .status # Should return null (success) or "error" ``` --- ### 403...