HubSpot integration
CRM platform API for managing contacts, companies, deals, and marketing automation. Create and manage customer relationships, track sales pipelines, associate objects, search with advanced filters, and access property schemas. Perfect for building CRM integrations, sales automation tools, marketing platforms, and customer data management systems.
Say what should happen.
The workflow builds itself.
Common HubSpot use cases
- Clean test data
- Call logging
- Communication history
- Log meetings
- Email tracking
- Form management
- Lead processing
- Task management
- Bulk deal import
- Form submissions
What you can do with HubSpot
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Contact, 10 operations
batch_create_contactsBatch create contactsPOSTCreates multiple contact records in a single API call for bulk imports.batch_read_contactsBatch read contactsPOSTRetrieves multiple contacts by ID or email in a single efficient request.batch_update_contactsBatch update contactsPOSTUpdates multiple contact records in a single API call for bulk modifications.batch_upsert_contactsBatch upsert contactsPOSTCreates new contacts or updates existing ones based on email or custom unique property.create_contactCreate contactPOSTCreates a new contact record in HubSpot CRM with specified properties. Supports deduplication by email and allows setting any standard or custom contact properties during creation.delete_contactDelete contactDELETEPermanently removes a contact from HubSpot CRM by their unique identifier. Deletes the contact record and associated data, supporting GDPR compliance and data cleanup workflows.get_contactGet contactGETRetrieves detailed information for a specific CRM contact by their unique identifier. Returns contact properties, associations, and metadata for individual contact lookups and detail views.list_contactsList contactsGETRetrieves a paginated list of CRM contacts with customizable property selection. Supports cursor-based pagination for efficiently iterating through large contact databases with specific field filtering.search_contactsSearch contactsPOSTSearches contacts using powerful filter groups with multiple operators and AND/OR logic. Enables complex queries across any contact property for targeted contact retrieval.update_contactUpdate contactPATCHUpdates existing contact properties in HubSpot CRM by contact ID. Performs partial updates allowing modification of specific fields without affecting others.
Company, 7 operations
batch_create_companiesBatch create companiesPOSTCreates multiple company records in a single API call.create_companyCreate companyPOSTCreates a new company record in HubSpot CRM with specified business properties. Establishes account records for B2B sales tracking and organizational data management.delete_companyDelete companyDELETEPermanently removes a company record from the CRM.get_companyGet companyGETRetrieves a specific company record by ID with customizable property selection.list_companiesList companiesGETRetrieves a paginated list of company records from HubSpot CRM. Returns company properties like name, domain, industry, and size for account management and B2B workflows.search_companiesSearch companiesPOSTSearches companies using filter groups with multiple operators and AND/OR logic.update_companyUpdate companyPATCHUpdates company properties like name, domain, industry, or custom fields.
Deal, 7 operations
batch_create_dealsBatch create dealsPOSTCreates multiple deal records in a single API call for bulk operations.create_dealCreate dealPOSTCreates a new sales deal/opportunity in HubSpot CRM with pipeline stage and value. Tracks revenue opportunities through customizable sales stages for forecasting and reporting.delete_dealDelete dealDELETEPermanently removes a deal from the CRM.get_dealGet dealGETRetrieves a specific deal's details including all properties and associations.list_dealsList dealsGETRetrieves a paginated list of sales deals from HubSpot CRM for pipeline management.search_dealsSearch dealsPOSTSearches deals using filter groups for targeted pipeline queries.update_dealUpdate dealPATCHUpdates deal properties like amount, stage, or close date.
Ticket, 6 operations
create_ticketCreate ticketPOSTCreates a new support ticket with subject, status, and priority.delete_ticketDelete ticketDELETEPermanently removes a support ticket from the system.get_ticketGet ticketGETRetrieves a specific support ticket by ID with all properties.list_ticketsList ticketsGETRetrieves all support tickets from HubSpot Service Hub.search_ticketsSearch ticketsPOSTSearches tickets using filter groups with multiple operators for targeted retrieval.update_ticketUpdate ticketPATCHUpdates ticket properties like status, priority, or owner assignment.
Association, 5 operations
associate_objectsAssociate objectsPUTCreates relationships between HubSpot CRM objects such as contacts, companies, and deals. Enables linking records to build complete customer relationship graphs.batch_read_associationsBatch read associationsPOSTRetrieves associations for multiple records in a single request using v4 API.create_default_associationCreate default associationPUTCreates a default unlabeled association between two CRM records using v4 API.delete_associationDelete associationDELETERemoves an association between two CRM records without deleting either record.get_associationsGet associationsGETRetrieves all associations from a specific record to a target object type using v4 API.
Note, 5 operations
create_noteCreate notePOSTCreates a new note with content and optional associations to contacts, companies, or deals.delete_noteDelete noteDELETEPermanently removes a note engagement.get_noteGet noteGETRetrieves a specific note by ID with its content and metadata.list_notesList notesGETRetrieves all notes/engagements with optional associations.update_noteUpdate notePATCHUpdates the content or properties of an existing note.
Call, 2 operations
create_callCreate callPOSTCreates a call engagement with duration, outcome, and notes.list_callsList callsGETRetrieves all call engagements with duration, outcome, and associations.
Email, 2 operations
create_emailCreate emailPOSTCreates an email engagement to log sent or received emails.list_emailsList emailsGETRetrieves all email engagements with subject, body, and tracking data.
Meeting, 2 operations
create_meetingCreate meetingPOSTCreates a meeting engagement with title, time, and outcome.list_meetingsList meetingsGETRetrieves all meeting engagements with details and attendees.
Owner, 2 operations
get_ownerGet ownerGETRetrieves details for a specific HubSpot owner by ID, including name, email, and team assignments.list_ownersList ownersGETRetrieves all HubSpot users who can be assigned as owners of CRM records. Returns user details for sales rep assignment, contact routing, and team management.
Pipeline, 2 operations
get_pipelineGet pipelineGETRetrieves a specific pipeline and its stages by pipeline ID.list_pipelinesList pipelinesGETRetrieves all pipelines and their stages for deals or tickets.
Property, 2 operations
create_propertyCreate propertyPOSTCreates a new custom property for a CRM object type with specified data type and field configuration.get_propertiesGet propertiesGETRetrieves all available properties (fields) for a CRM object type. Returns property definitions including names, types, and options for dynamic form building and data validation.
Task, 2 operations
create_taskCreate taskPOSTCreates a new task with subject, status, priority, and associations.list_tasksList tasksGETRetrieves all tasks with their status, due dates, and assignments.
Association label, 1 operation
get_association_labelsGet association labelsGETRetrieves all available association types and labels for object relationships.
Form, 1 operation
list_formsList formsGETRetrieves all HubSpot marketing forms.
Pipeline stage, 1 operation
list_pipeline_stagesList pipeline stagesGETRetrieves all stages for a specific pipeline including display order and metadata.
Submission, 1 operation
get_form_submissionsGet form submissionsGETRetrieves form submission data for a specific form.
Workflow, 1 operation
list_workflowsList workflowsGETRetrieves all automation workflows in HubSpot.
OAuth scopes HubSpot requires
Each operation declares the scopes HubSpot requires for it.
crm.objects.contacts.writeneeded by batch_create_contacts, batch_update_contacts, batch_upsert_contacts and 3 morecrm.objects.companies.writeneeded by batch_create_companies, create_company, delete_company and 1 morecrm.objects.contacts.readneeded by batch_read_contacts, get_contact, list_contacts and 1 morecrm.objects.deals.writeneeded by batch_create_deals, create_deal, delete_deal and 1 morecrm.objects.companies.readneeded by get_company, list_companies, search_companiescrm.objects.deals.readneeded by get_deal, list_deals, search_dealsformsneeded by get_form_submissions, list_formsautomationneeded by list_workflows
HubSpot API rate limits
- 660 requests per minute
110 req/10s for OAuth apps. 250,000 daily limit varies by plan.
These are the limits HubSpot documents, not ones LiveContext measured. They can change and often depend on your plan, so check the HubSpot documentation for current values.
Use HubSpot from Claude Code, Cursor or Codex
Connect HubSpot in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its HubSpot operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect HubSpot
- Create your workspace
Sign up free. Nothing to install.
- Connect HubSpot once
Add your HubSpot connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
HubSpot integration FAQ
What can you do with the HubSpot integration?
LiveContext exposes 59 operations on HubSpot, covering contact, company, deal and ticket. Common uses include Clean test data, Call logging and Communication history.
Which OAuth scopes does HubSpot require?
It depends on the operation: each one declares the scopes HubSpot requires for it. The most common are crm.objects.contacts.write (6 operations), crm.objects.companies.write (4 operations), crm.objects.contacts.read (4 operations) and crm.objects.deals.write (4 operations).
What are the HubSpot API rate limits?
HubSpot documents 660 requests per minute. 110 req/10s for OAuth apps. 250,000 daily limit varies by plan. Limits are set by HubSpot and can depend on your plan.
