hubspot-common-errors

Featured

Diagnose and fix common HubSpot API errors with real error responses. Use when encountering HubSpot errors, debugging failed API requests, or troubleshooting integration issues with specific HTTP status codes. Trigger with phrases like "hubspot error", "fix hubspot", "hubspot 401", "hubspot 429", "hubspot not working", "debug hubspot API".

AI & Automation 2,266 stars 315 forks Updated today MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
7 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

hootsuite-common-errors

Diagnose and fix Hootsuite common errors and exceptions. Use when encountering Hootsuite errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "hootsuite error", "fix hootsuite", "hootsuite not working", "debug hootsuite".

2,266 Updated today
jeremylongshore
AI & Automation Featured

hubspot-known-pitfalls

Identify and avoid HubSpot API anti-patterns and common integration mistakes. Use when reviewing HubSpot code, onboarding developers to HubSpot integrations, or auditing existing CRM integrations for best practice violations. Trigger with phrases like "hubspot mistakes", "hubspot anti-patterns", "hubspot pitfalls", "hubspot code review", "hubspot gotchas".

2,266 Updated today
jeremylongshore
AI & Automation Featured

hubspot-install-auth

Install and configure HubSpot API client with authentication. Use when setting up a new HubSpot integration, configuring private app tokens, OAuth 2.0 flows, or initializing the @hubspot/api-client SDK. Trigger with phrases like "install hubspot", "setup hubspot auth", "hubspot access token", "configure hubspot API", "hubspot private app".

2,266 Updated today
jeremylongshore
AI & Automation Featured

hubspot-advanced-troubleshooting

Debug complex HubSpot API issues with systematic isolation and evidence collection. Use when standard troubleshooting fails, investigating intermittent CRM errors, or preparing evidence bundles for HubSpot support escalation. Trigger with phrases like "hubspot hard bug", "hubspot mystery error", "hubspot intermittent failure", "hubspot deep debug", "hubspot support ticket".

2,266 Updated today
jeremylongshore
AI & Automation Featured

intercom-common-errors

Diagnose and fix Intercom API errors by HTTP status code and error type. Use when encountering Intercom errors, debugging failed API requests, or troubleshooting integration issues. Trigger with phrases like "intercom error", "fix intercom", "intercom not working", "debug intercom", "intercom 401", "intercom 429".

2,266 Updated today
jeremylongshore