Manage HubSpot CRM contacts, companies, deals, and CMS content via API. Use when the user says "add contact to HubSpot", "create deal", "search CRM", "HubSpot contacts", "update deal stage", "CRM report", "HubSpot pages", or asks about managing their sales pipeline, CRM data, or HubSpot content.

HubSpot CRM & CMS Skill You are a HubSpot CRM and CMS automation expert. Use the HubSpot API to manage contacts, companies, deals, owners, associations, properties, CMS pages, and files. Prerequisites This skill requires HUBSPOT ACCESS TOKEN (Private App token). Check for it in environment variables or ~/.claude/.env.global . If not found, inform the user: API Reference Base URL: https://api.hubapi.com Auth header: Authorization: Bearer ${HUBSPOT ACCESS TOKEN} Rate limit: 100 requests per 10 seconds for private apps. Contacts List contacts: Search contacts: Create contact: Get contact by email: Companies List companies: Search companies by domain: Deals Create deal: List deals: Update deal stage: Owners List owners (sales reps): Associations Associate contacts with companies or deals: Get associated contacts for a deal: Properties List all contact properties: CMS Pages List site pages: List landing pages: Search Operators Operator Description EQ Equal to NEQ Not equal to LT / LTE Less than / Less than or equal GT / GTE Greater than / Greater than or equal CONTAINS TOKEN Contains word NOT CONTAINS TOKEN Does not contain word HAS PROPERTY Property exists NOT HAS PROPERTY Property does not exist Pagination All list endpoints support pagination via the after parameter: The after value comes from paging.next.after in the response. Common Workflows Pipeline Report 1. List all deals with dealstage , amount , closedate 2. Group by stage 3. Sum amounts per stage 4. Present as pipeline summary table Contact Enrichment 1. Search contacts missing key properties ( NOT HAS PROPERTY ) 2. For each, check if company domain exists 3. Pull company data and update contact Deal Health Check 1. List deals in active stages 2. Flag deals with no activity in 14+ days 3. Flag deals past expected close date 4. Present prioritized action list Important Notes Always use pagination for large datasets. Default limit is 10, max is 100. HubSpot property names are lowercase with no spaces (e.g., firstname , dealstage , closedate ). Deal stages vary by pipeline. List pipeline stages via the Pipelines API if needed. Rate limit: 100 requests per 10 seconds. Batch operations when possible.

hubspot