skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

hubspot-master

Provides shared references and Python scripts for HubSpot CRM API integration skills.

Updated Jan 22, 2026
Search Tags:#automation#python#crm#api integration#hubspot#contacts#deals
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-master-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hubspot-master
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-master
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-master-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? HubSpot integration skills would otherwise duplicate setup instructions, API documentation, authentication flows, and error handling logic. This shared resource library centralizes that content so every HubSpot skill works from a single source of truth. ## Core Features & Use Cases - Shared API Client: A reusable Python client (hubspot_client.py) with Bearer token authentication, automatic retry on rate limits, and structured error parsing. - CRM Operation Scripts: Ready-to-run scripts for contacts, companies, deals, associations, and engagements (emails, calls, notes, meetings) with JSON output options. - Configuration Diagnostics: A pre-flight checker that validates the .env token, tests the API connection, and returns an ai_action field telling the AI exactly how to fix setup issues. - Use Case: When a user asks to create a HubSpot contact but the token is missing, the config checker returns prompt_for_access_token, guiding the AI to collect the Private App token and write it to .env before retrying. ## Quick Start Ask the AI to check your HubSpot configuration by running the check_hubspot_config script before performing any CRM operation.

Frequently Asked Questions about hubspot-master

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up HubSpot API authentication with a Private App?▼

Create a Private App in HubSpot under Settings, Integrations, Private Apps, select the required CRM scopes, and copy the access token starting with pat-. Add it to your .env file as HUBSPOT_ACCESS_TOKEN, then run check_hubspot_config.py to verify the connection.

How do I create a contact in HubSpot using Python?▼

Run create_contact.py with the required --email argument and optional --firstname, --lastname, --phone, and --company flags. The script posts to the HubSpot CRM v3 contacts endpoint and prints the new contact ID or structured JSON with --json.

Why does the HubSpot API return a 403 Forbidden error?▼

A 403 error means your Private App is missing a required scope such as crm.objects.contacts.read. Add the scope in your Private App settings and regenerate the access token, since scope changes require a new token.

What happens when HubSpot rate limits my API requests?▼

HubSpot allows 100 requests per 10 seconds and returns 429 with a Retry-After header when exceeded. The shared hubspot_client.py automatically waits and retries with exponential backoff, so scripts recover without manual intervention.

Can I search HubSpot contacts by name or company?▼

Yes, search_contacts.py supports --email for exact match, --name for first or last name contains matching, and --company for company filtering. It uses the HubSpot search endpoint with EQ and CONTAINS_TOKEN operators.

Related Skills

Explore More Marketing & Sales Skills→
Shakudo-ioShakudo-io

hubspot

Automates HubSpot CRM REST API CRUD, search, and association operations for core objects.

Official
Advanced
refly-airefly-ai
199

hubspot

Manage HubSpot CRM contacts and deals with CRUD operations.

Official
Intermediate
OpenLaborOpenLabor
4

Contact Enrichment

Enrich lead contact data with verified emails, phone numbers, and LinkedIn profiles.

Official
Intermediate
baselakkad585-makerbaselakkad585-maker

hubspot-integration

Implement OAuth 2.0 and private app token authentication for HubSpot CRM integrations.

Community
Intermediate