hubspot-integration_skill
- Python
21
GitHub Stars
1
Bundled Files
2 months ago
Catalog Refreshed
4 months ago
First Indexed
Readme & install
Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.
Installation
Preview and clipboard use veilstrat where the catalogue uses aiagentskills.
npx veilstrat add skill omer-metin/skills-for-antigravity --skill hubspot-integration- SKILL.md1.2 KB
Overview
This skill provides expert patterns for integrating with HubSpot CRM, covering OAuth flows, CRM objects and associations, batch operations, webhooks, and custom objects. It includes practical guidance for both Node.js and Python SDKs and highlights critical risks and validation rules to follow.
How this skill works
I inspect the integration requirements and map them to established patterns for creation, diagnosis, and review. For implementation guidance I follow the prescribed creation patterns; for diagnosing failures I use edge-case guidance to explain root causes and mitigation; for reviews I validate inputs and outputs against strict validation rules.
When to use it
- Building or refactoring HubSpot OAuth authentication and token refresh logic
- Designing CRUD or batch operations for contacts, companies, deals, or custom objects
- Implementing or troubleshooting HubSpot webhooks and event delivery
- Modeling associations between CRM objects at scale
- Choosing between Node.js and Python SDK approaches for production integrations
Best practices
- Use the documented OAuth pattern for initial authorization and safe token refresh; persist refresh tokens securely
- Apply batch operations for high-volume syncs and respect API rate limits and retry semantics
- Validate incoming webhook payloads and implement idempotency to handle duplicates
- Model associations explicitly and maintain canonical IDs to avoid orphaned records
- Run strict input validations before sending data to HubSpot to prevent schema rejections
Example use cases
- Syncing a large customer database into HubSpot using paginated batch imports with retries
- Implementing a webhook receiver that validates signatures, deduplicates events, and updates related CRM objects
- Migrating custom objects from another CRM, mapping properties and associations while preserving referential integrity
- Building a Node.js or Python microservice that handles OAuth token lifecycle and exposes a stable API for downstream services
FAQ
Choose the SDK that matches your service stack and team expertise. Both follow the same API semantics; prioritize runtime performance and library maturity in your environment.
How do I avoid data duplication in webhooks?
Validate signatures, use event IDs for deduplication, and implement idempotent updates on CRM objects.
What are common failure modes?
Common failures include expired tokens, rate-limited batch jobs, schema validation errors, and lost associations; diagnose these using edge-case guidance and apply the recommended mitigations.
