hubspotHubSpot CRM and CMS API integration for contacts, companies, deals, owners, and content management.
Install via ClawdBot CLI:
clawdbot install kwall1/hubspotRequires:
Interact with HubSpot CRM and CMS via the REST API.
Set your HubSpot Private App access token:
HUBSPOT_ACCESS_TOKEN=pat-na2-xxxxxAll endpoints use: https://api.hubapi.com
Authorization header: Bearer $HUBSPOT_ACCESS_TOKEN
Create contact:
curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"properties":{"email":"test@example.com","firstname":"Test","lastname":"User","phone":"555-1234","company":"Acme Inc","jobtitle":"Manager"}}' \
"https://api.hubapi.com/crm/v3/objects/contacts" | jqList contacts:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/contacts?limit=10" | jqSearch contacts:
curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filterGroups":[{"filters":[{"propertyName":"email","operator":"CONTAINS_TOKEN","value":"example.com"}]}],"limit":10}' \
"https://api.hubapi.com/crm/v3/objects/contacts/search" | jqGet contact by ID:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/contacts/{contactId}?properties=email,firstname,lastname,phone,company" | jqGet contact by email:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/contacts/{email}?idProperty=email" | jqList companies:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/companies?limit=10&properties=name,domain,industry" | jqSearch companies:
curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filterGroups":[{"filters":[{"propertyName":"name","operator":"CONTAINS_TOKEN","value":"acme"}]}],"limit":10}' \
"https://api.hubapi.com/crm/v3/objects/companies/search" | jqGet company by ID:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/companies/{companyId}?properties=name,domain,industry,numberofemployees" | jqCreate deal:
curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"properties":{"dealname":"New Deal","amount":"10000","closedate":"2026-06-01","description":"Deal notes here"}}' \
"https://api.hubapi.com/crm/v3/objects/deals" | jqList deals:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/deals?limit=10&properties=dealname,amount,dealstage,closedate" | jqSearch deals:
curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filterGroups":[{"filters":[{"propertyName":"dealstage","operator":"EQ","value":"closedwon"}]}],"limit":10}' \
"https://api.hubapi.com/crm/v3/objects/deals/search" | jqGet deal by ID:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/objects/deals/{dealId}?properties=dealname,amount,dealstage,closedate,pipeline" | jqList owners (users):
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/owners" | jqUpdate contact properties:
curl -s -X PATCH -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"properties":{"phone":"555-9999","jobtitle":"Director"}}' \
"https://api.hubapi.com/crm/v3/objects/contacts/{contactId}" | jqAssign owner to contact:
curl -s -X PATCH -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"properties":{"hubspot_owner_id":"{ownerId}"}}' \
"https://api.hubapi.com/crm/v3/objects/contacts/{contactId}" | jqAssign owner to deal:
curl -s -X PATCH -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"properties":{"hubspot_owner_id":"{ownerId}"}}' \
"https://api.hubapi.com/crm/v3/objects/deals/{dealId}" | jqGet associated contacts for a company:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v4/objects/companies/{companyId}/associations/contacts" | jqGet associated deals for a contact:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v4/objects/contacts/{contactId}/associations/deals" | jqCreate association (deal to contact):
curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"inputs":[{"from":{"id":"{dealId}"},"to":{"id":"{contactId}"},"types":[{"associationCategory":"HUBSPOT_DEFINED","associationTypeId":3}]}]}' \
"https://api.hubapi.com/crm/v4/associations/deals/contacts/batch/create" | jqCommon association type IDs:
List contact properties:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/properties/contacts" | jq '.results[].name'List company properties:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/properties/companies" | jq '.results[].name'List deal properties:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/crm/v3/properties/deals" | jq '.results[].name'List site pages:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/cms/v3/pages/site-pages?limit=10" | jqList landing pages:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/cms/v3/pages/landing-pages?limit=10" | jqList domains:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/cms/v3/domains" | jqList files:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/files/v3/files?limit=10" | jqSearch files:
curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
"https://api.hubapi.com/files/v3/files/search?name=logo" | jqFor search endpoints, use these operators in filters:
| Operator | Description |
|----------|-------------|
| EQ | Equal to |
| NEQ | Not equal to |
| LT | Less than |
| LTE | Less than or equal |
| GT | Greater than |
| GTE | Greater than or equal |
| CONTAINS_TOKEN | Contains word |
| NOT_CONTAINS_TOKEN | Does not contain word |
| HAS_PROPERTY | Has a value |
| NOT_HAS_PROPERTY | Does not have a value |
For Windows/PowerShell, use Invoke-RestMethod:
$headers = @{
"Authorization" = "Bearer $env:HUBSPOT_ACCESS_TOKEN"
"Content-Type" = "application/json"
}
# List contacts
Invoke-RestMethod -Uri "https://api.hubapi.com/crm/v3/objects/contacts?limit=10" -Headers $headers
# Search contacts
$body = @{
filterGroups = @(@{
filters = @(@{
propertyName = "email"
operator = "CONTAINS_TOKEN"
value = "example.com"
})
})
limit = 10
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Method POST -Uri "https://api.hubapi.com/crm/v3/objects/contacts/search" -Headers $headers -Body $bodyafter parameter from paging.next.after for next pagehttps://app-na2.hubspot.com/contacts/{portalId}/record/...Generated Mar 1, 2026
A sales team uses the skill to create and track deals, assign owners to leads, and associate deals with contacts and companies. They can search for deals by stage, update deal properties, and monitor progress through the pipeline, enabling efficient sales forecasting and management.
A marketing agency leverages the skill to manage client contacts, update contact details, and assign owners for follow-up. They can search contacts by email domain, list companies with industry data, and create associations between contacts and companies, streamlining client communication and segmentation.
An e-commerce business uses the skill to create contacts from leads, assign owners for personalized outreach, and track associated deals. They can update contact properties based on interactions and search for high-value leads, automating lead nurturing workflows and improving conversion rates.
A data analytics team utilizes the skill to list and manage custom properties for contacts, companies, and deals. They can retrieve schema details to ensure data consistency, enabling better data governance and integration with other systems for reporting and analysis.
Companies offering subscription-based software use the skill to manage customer contacts, track deal stages for upsells, and assign owners for account management. This supports recurring revenue models by enabling efficient CRM integration and customer lifecycle tracking.
Consulting firms leverage the skill to handle client companies, create deals for project engagements, and associate contacts with deals for billing. It facilitates project management and client retention through organized CRM data and owner assignments.
Marketing or freelance agencies use the skill to manage multiple clients, search for companies by industry, and update contact properties for campaign targeting. This model benefits from streamlined client management and deal tracking for service-based revenue.
💬 Integration Tip
Ensure the HUBSPOT_ACCESS_TOKEN is securely stored as an environment variable and use jq for parsing JSON responses to simplify data extraction in scripts.
Partnership outreach, market research, competitor analysis, and proposal generation. Transform your AI agent into a strategic business development partner that identifies and cultivates growth opportunities.
CRM integration, lead tracking, outreach automation, and pipeline management. Transform your AI agent into a sales assistant that never lets leads slip through the cracks.
Manage Zhihu AI Bot to publish, like/unlike, comment, delete comments, and fetch ring or comment details using Zhihu API credentials.
ActiveCampaign CRM integration for lead management, deal tracking, and email automation. Use for syncing demo leads, managing clinic sales pipeline, and triggering follow-up sequences.
Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND/OR logic, date ranges, follower counts, and bookmarks.
RevenueCat metrics, customer data, and documentation search. Use when querying subscription analytics, MRR, churn, customers, or RevenueCat docs.