Skip to main content

​
What can you do with it?

The HubSpot integration enables comprehensive CRM management including contacts, deals, and support tickets. You can search for existing records, create new entries, update information, and manage associations between different objects. This integration supports full lifecycle management from initial contact through deal closure and ongoing support, making it ideal for sales teams and customer service operations.

​
How to use it?

​
Basic Command Structure

/your-hubspot-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation you want to perform (search, create, update, fetch)
Optional:
  • object_type - The HubSpot object type (contact, deal, ticket)
  • properties - Specific properties to retrieve or update

​
Tools

​
Search Contacts

Search for contacts using various filters and properties Parameters:
  • email (optional) - Email address to search for
  • firstname (optional) - First name to search for
  • lastname (optional) - Last name to search for
  • query (optional) - General search query
  • properties (optional) - Properties to return in results
  • limit (optional) - Maximum number of results (default: 10)
Example: 
/your-hubspot-connection
action: search_contact
email: john.doe@example.com
properties: firstname, lastname, email, phone
Response: 
{
  "total": "[Number of matching contacts]",
  "results": "[Array of contact objects with requested properties]"
}

​
Create Contact

Create a new contact record Parameters:
  • email (required) - Contact email address
  • firstname (optional) - Contact first name
  • lastname (optional) - Contact last name
  • phone (optional) - Contact phone number
Example: 
/your-hubspot-connection
action: create_contact
email: newcontact@example.com
firstname: Jane
lastname: Smith
phone: 1234567890
Response: 
{
  "id": "[Created contact ID]",
  "properties": "[Contact properties object]"
}

​
Update Contact

Update existing contact properties Parameters:
  • contact_id (required) - The ID of the contact to update
  • properties (required) - Object containing properties to update
Example: 
/your-hubspot-connection
action: update_contact
contact_id: 123
firstname: Updated First Name
phone: 9876543210
Response: 
{
  "id": "[Contact ID]",
  "properties": "[Updated contact properties]"
}

​
Create Deal

Create a new deal and optionally associate it with a contact Parameters:
  • dealname (required) - Name of the deal
  • dealstage (required) - Current stage of the deal
  • amount (optional) - Deal amount
  • closedate (optional) - Expected close date
  • contact_id (optional) - ID of contact to associate with
Example: 
/your-hubspot-connection
action: create_deal
dealname: New Business Deal
dealstage: appointmentscheduled
amount: 5000
closedate: 2025-03-01T12:00:00Z
contact_id: 123
Response: 
{
  "id": "[Created deal ID]",
  "properties": "[Deal properties object]"
}

​
Update Deal

Update deal properties including stage and amount Parameters:
  • deal_id (required) - The ID of the deal to update
  • dealstage (optional) - New deal stage
  • amount (optional) - Updated deal amount
  • dealname (optional) - Updated deal name
  • closedate (optional) - Updated close date
Example: 
/your-hubspot-connection
action: update_deal
deal_id: 789
dealstage: presentationscheduled
amount: 7500
dealname: Updated Deal Name
Response: 
{
  "id": "[Deal ID]",
  "properties": "[Updated deal properties]"
}

​
Create Ticket

Create a support ticket and optionally associate it with a contact Parameters:
  • subject (required) - Ticket subject
  • content (required) - Ticket description
  • priority (optional) - Ticket priority (HIGH, MEDIUM, LOW)
  • pipeline (optional) - Pipeline ID (default: 0)
  • pipeline_stage (optional) - Pipeline stage ID (default: 1)
  • contact_id (optional) - ID of contact to associate with
Example: 
/your-hubspot-connection
action: create_ticket
subject: Technical Support Required
content: Customer is experiencing login issues
priority: HIGH
contact_id: 123
Response: 
{
  "id": "[Created ticket ID]",
  "properties": "[Ticket properties object]"
}

​
Update Ticket

Update ticket properties including status and priority Parameters:
  • ticket_id (required) - The ID of the ticket to update
  • pipeline_stage (optional) - New pipeline stage
  • priority (optional) - Updated priority
  • content (optional) - Updated description
Example: 
/your-hubspot-connection
action: update_ticket
ticket_id: 321
pipeline_stage: 2
priority: MEDIUM
content: Updated ticket description with customer feedback
Response: 
{
  "id": "[Ticket ID]",
  "properties": "[Updated ticket properties]"
}

​
Fetch Deals

Retrieve a list of deals with pagination and filtering Parameters:
  • limit (required) - Maximum number of results per page
  • after (optional) - Pagination cursor from previous response
  • properties (optional) - Properties to return
  • associations (optional) - Associated objects to retrieve
  • archived (optional) - Whether to return archived results
Example: 
/your-hubspot-connection
action: fetch_deals
limit: 10
properties: dealname, amount, dealstage, closedate
associations: contact, company
Response: 
{
  "results": "[Array of deal objects]",
  "paging": "[Pagination information including next cursor]"
}

​
Fetch Tickets

Retrieve support tickets with filtering and sorting Parameters:
  • limit (optional) - Maximum number of results (default: 50)
  • properties (optional) - Properties to return
  • priority_filter (optional) - Filter by priority (HIGH, MEDIUM, LOW)
  • sort (optional) - Sort order (default: -createdate)
Example: 
/your-hubspot-connection
action: fetch_tickets
limit: 50
properties: subject, content, hs_pipeline_stage, hs_ticket_priority
priority_filter: HIGH
Response: 
{
  "total": "[Total number of tickets]",
  "results": "[Array of ticket objects]"
}

​
Notes

When searching for contacts, you can use multiple filter groups with OR logic between groups and AND logic within groups. Deal stages and ticket priorities use specific HubSpot values that should match your portal configuration. Association type IDs are predefined: use typeId 3 for contact-to-deal associations and typeId 16 for contact-to-ticket associations. Properties can be specified multiple times in fetch operations for granular control over returned data.
⌘I