hubspot
Complete guide to all HubSpot CRM tools — contacts, companies, deals, tickets, products, line items, pipelines, and entity management.
- License 许可
- MIT
- 最近更新
- 2026-10-27
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- hubspot
- license
- MIT
- version
- 1.0.0
- metadata
- { "tags": "hubspot,crm,contacts,deals,companies,pipeline,sales", "author": "Matimo", "apply-to": "hubspot-create-contact hubspot-get-contact hubspot-update-contact hubspot-delete-contact hubspot-list-contacts hubspot-create-company hubspot-get-company hubspot-update-company hubspot-delete-company hubspot-list-companies hubspot-create-deal hubspot-get-deal hubspot-update-deal hubspot-delete-deal hubspot-list-deals hubspot-create-ticket hubspot-get-ticket hubspot-update-ticket hubspot-delete-ticket hubspot-list-tickets hubspot-create-product hubspot-get-product hubspot-update-product hubspot-delete-product hubspot-list-products hubspot-create-line-item hubspot-get-line-item hubspot-update-line-item hubspot-delete-line-item hubspot-list-line-items hubspot-create-quote hubspot-get-quote hubspot-update-quote hubspot-delete-quote hubspot-list-quotes hubspot-create-task hubspot-get-task hubspot-update-task hubspot-delete-task hubspot-list-tasks hubspot-create-note hubspot-get-note hubspot-update-note hubspot-delete-note hubspot-list-notes hubspot-create-meeting hubspot-get-meeting hubspot-update-meeting hubspot-delete-meeting hubspot-list-meetings hubspot-create-call hubspot-get-call hubspot-update-call hubspot-delete-call hubspot-list-calls", "category": "CRM", "difficulty": "intermediate" }
- description
- Complete guide to all HubSpot CRM tools — contacts, companies, deals, tickets, products, line items, pipelines, and entity management.
03 SKILL.md 正文
HubSpot
Complete guide to using Matimo's HubSpot CRM tools for managing contacts, companies, deals, tickets, and all CRM entities.
Entity Types & Tools
HubSpot tools follow a CRUD pattern. Each entity type has 5 operations:
| Entity | Create | Get | Update | Delete | List |
|---|---|---|---|---|---|
| Contacts | hubspot-create-contact |
hubspot-get-contact |
hubspot-update-contact |
hubspot-delete-contact |
hubspot-list-contacts |
| Companies | hubspot-create-company |
hubspot-get-company |
hubspot-update-company |
hubspot-delete-company |
hubspot-list-companies |
| Deals | hubspot-create-deal |
hubspot-get-deal |
hubspot-update-deal |
hubspot-delete-deal |
hubspot-list-deals |
| Tickets | hubspot-create-ticket |
hubspot-get-ticket |
hubspot-update-ticket |
hubspot-delete-ticket |
hubspot-list-tickets |
| Products | hubspot-create-product |
hubspot-get-product |
hubspot-update-product |
hubspot-delete-product |
hubspot-list-products |
| Line Items | hubspot-create-line-item |
hubspot-get-line-item |
hubspot-update-line-item |
hubspot-delete-line-item |
hubspot-list-line-items |
| Quotes | hubspot-create-quote |
hubspot-get-quote |
hubspot-update-quote |
hubspot-delete-quote |
hubspot-list-quotes |
| Tasks | hubspot-create-task |
hubspot-get-task |
hubspot-update-task |
hubspot-delete-task |
hubspot-list-tasks |
| Notes | hubspot-create-note |
hubspot-get-note |
hubspot-update-note |
hubspot-delete-note |
hubspot-list-notes |
| Meetings | hubspot-create-meeting |
hubspot-get-meeting |
hubspot-update-meeting |
hubspot-delete-meeting |
hubspot-list-meetings |
| Calls | hubspot-create-call |
hubspot-get-call |
hubspot-update-call |
hubspot-delete-call |
hubspot-list-calls |
Authentication
Requires HUBSPOT_ACCESS_TOKEN (private app token) or OAuth2. Token needs scopes: crm.objects.contacts.read, crm.objects.contacts.write, etc.
Core Operations
Create
All create tools accept a properties object:
{ "properties": { "email": "alice@acme.com", "firstname": "Alice", "lastname": "Smith" } }
Returns the created object with its id.
Get
All get tools accept an objectId (string) and optional properties list to limit returned fields.
Update
All update tools accept objectId and properties with fields to change.
Delete
All delete tools accept objectId. Moves to recycling bin (recoverable for 90 days).
List
All list tools accept optional limit (max 100), after (cursor for pagination), and properties (fields to return).
Contacts
Key properties: email, firstname, lastname, phone, company, website, lifecyclestage (subscriber → lead → opportunity → customer).
Best practices:
- Always deduplicate by email before creating
- Set
lifecyclestageappropriately - Use
hs_lead_statusto track sales qualification
Companies
Key properties: name, domain, industry, numberofemployees, annualrevenue, city, state, country.
Best practices:
- Use
domainas the unique identifier - Associate contacts to companies after creation
Deals
Key properties: dealname, dealstage, pipeline, amount, closedate, hubspot_owner_id.
Pipeline stages (default): appointmentscheduled → qualifiedtobuy → presentationscheduled → decisionmakerboughtin → contractsent → closedwon / closedlost.
Best practices:
- Always set
pipelinewhen creating - Update
dealstageas deal progresses - Set
amountandclosedatefor forecasting
Tickets
Key properties: subject, content, hs_pipeline, hs_pipeline_stage, hs_ticket_priority (HIGH/MEDIUM/LOW).
Engagement Entities
Tasks, Notes, Meetings, and Calls are engagement objects that track interactions.
Tasks: hs_task_subject, hs_task_body, hs_task_status (NOT_STARTED/IN_PROGRESS/COMPLETED), hs_task_priority.
Notes: hs_note_body, hs_timestamp.
Meetings: hs_meeting_title, hs_meeting_body, hs_meeting_start_time, hs_meeting_end_time.
Calls: hs_call_title, hs_call_body, hs_call_duration, hs_call_direction (INBOUND/OUTBOUND).
Common Workflows
Lead Qualification Pipeline
- Create contact:
hubspot-create-contact - Create company:
hubspot-create-company - Create deal:
hubspot-create-dealin first pipeline stage - Log activities:
hubspot-create-note,hubspot-create-call - Progress deal:
hubspot-update-dealto advance stage
Support Ticket Flow
- Create ticket:
hubspot-create-ticketwith priority - Log investigation:
hubspot-create-note - Update status:
hubspot-update-ticketas work progresses - Close:
hubspot-update-ticketto closed stage
Bulk Operations
- List entities with pagination (
aftercursor) - Process each entity
- HubSpot rate limit: 100 requests per 10 seconds
Common Errors
| Error | Cause | Fix |
|---|---|---|
401 Unauthorized |
Invalid token | Check HUBSPOT_ACCESS_TOKEN |
404 Not Found |
Invalid object ID | Verify ID exists |
409 Conflict |
Duplicate (e.g., email exists) | Search first, then create |
429 Rate limit |
Too many requests | 100 req/10 sec — implement backoff |
400 Property doesn't exist |
Wrong property name | Check HubSpot property definitions |
04 同仓库更多 Skills
twilio
Complete guide to all Twilio tools — text, media, delivery tracking, E.164 formatting, and message management.
slack
Complete guide to all Slack tools — messaging, channels, users, search, files, reactions, and threads.
postgres
Complete guide to all PostgreSQL tools — parameterized queries, schema navigation, data retrieval, and safe database interaction patterns.
notion
Complete guide to all Notion tools — databases, pages, blocks, queries, and content management.
mailchimp
Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.
gmail
Complete guide to all Gmail tools — inbox management, email sending, labels, search, and threads.