HubSpot

Interact with HubSpot CRM or trigger workflows from HubSpot events

HubSpot is a comprehensive CRM platform that provides a full suite of marketing, sales, and customer service tools to help businesses grow better. With its powerful automation capabilities and extensive API, HubSpot has become one of the world's leading CRM platforms, serving businesses of all sizes across industries.

HubSpot CRM offers a complete solution for managing customer relationships, from initial contact through to long-term customer success. The platform combines contact management, deal tracking, marketing automation, and customer service tools into a unified system that helps teams stay aligned and focused on customer success.

Key features of HubSpot CRM include:

  • Contact & Company Management: Comprehensive database for storing and organizing customer and prospect information
  • Deal Pipeline: Visual sales pipeline for tracking opportunities through customizable stages
  • Marketing Events: Track and manage marketing campaigns and events with detailed attribution
  • Ticket Management: Customer support ticketing system for tracking and resolving customer issues
  • Quotes & Line Items: Create and manage sales quotes with detailed product line items
  • User & Team Management: Organize teams, assign ownership, and track user activity across the platform

In Sim, the HubSpot integration enables your AI agents to seamlessly interact with your CRM data and automate key business processes. This creates powerful opportunities for intelligent lead qualification, automated contact enrichment, deal management, customer support automation, and data synchronization across your tech stack. The integration allows agents to create, retrieve, update, and search across all major HubSpot objects, enabling sophisticated workflows that can respond to CRM events, maintain data quality, and ensure your team has the most up-to-date customer information. By connecting Sim with HubSpot, you can build AI agents that automatically qualify leads, route support tickets, update deal stages based on customer interactions, generate quotes, and keep your CRM data synchronized with other business systems—ultimately increasing team productivity and improving customer experiences.

Usage Instructions

Integrate HubSpot into your workflow. Manage contacts, companies, deals, tickets, and other CRM objects with powerful automation capabilities. Can be used in trigger mode to start workflows when contacts are created, deleted, or updated.

Tools

hubspot_get_users

Retrieve all users from HubSpot account

Input

ParameterTypeRequiredDescription
limitstringNoNumber of results to return (default: 100, max: 100)

Output

ParameterTypeDescription
usersarrayArray of HubSpot user objects
idstringUser ID
emailstringUser email address
roleIdstringUser role ID
primaryTeamIdstringPrimary team ID
secondaryTeamIdsarraySecondary team IDs
superAdminbooleanWhether user is a super admin
totalItemsnumberTotal number of users returned
successbooleanOperation success status

hubspot_list_contacts

Retrieve all contacts from HubSpot account with pagination support

Input

ParameterTypeRequiredDescription
limitstringNoMaximum number of results per page (max 100, default 100)
afterstringNoPagination cursor for next page of results (from previous response)
propertiesstringNoComma-separated list of HubSpot property names to return (e.g., "email,firstname,lastname,phone")
associationsstringNoComma-separated list of object types to retrieve associated IDs for (e.g., "companies,deals")

Output

ParameterTypeDescription
contactsarrayArray of HubSpot contact records
emailstringContact email address
firstnamestringContact first name
lastnamestringContact last name
phonestringContact phone number
mobilephonestringContact mobile phone number
companystringAssociated company name
websitestringContact website URL
jobtitlestringContact job title
lifecyclestagestringLifecycle stage (subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer)
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
createdatestringContact creation date (ISO 8601)
lastmodifieddatestringLast modified date (ISO 8601)
addressstringStreet address
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
faxstringFax number
hs_timezonestringContact timezone
pagingobjectPagination information for fetching more results
afterstringCursor for next page of results
linkstringLink to next page
metadataobjectResponse metadata
totalReturnednumberNumber of records returned in this response
hasMorebooleanWhether more records are available
successbooleanOperation success status

hubspot_get_contact

Retrieve a single contact by ID or email from HubSpot

Input

ParameterTypeRequiredDescription
contactIdstringYesThe HubSpot contact ID (numeric string) or email address to retrieve
idPropertystringNoProperty to use as unique identifier (e.g., "email"). If not specified, uses record ID
propertiesstringNoComma-separated list of HubSpot property names to return (e.g., "email,firstname,lastname,phone")
associationsstringNoComma-separated list of object types to retrieve associated IDs for (e.g., "companies,deals")

Output

ParameterTypeDescription
contactobjectHubSpot contact record
emailstringContact email address
firstnamestringContact first name
lastnamestringContact last name
phonestringContact phone number
mobilephonestringContact mobile phone number
companystringAssociated company name
websitestringContact website URL
jobtitlestringContact job title
lifecyclestagestringLifecycle stage (subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer)
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
createdatestringContact creation date (ISO 8601)
lastmodifieddatestringLast modified date (ISO 8601)
addressstringStreet address
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
faxstringFax number
hs_timezonestringContact timezone
contactIdstringThe retrieved contact ID
successbooleanOperation success status

hubspot_create_contact

Create a new contact in HubSpot. Requires at least one of: email, firstname, or lastname

Input

ParameterTypeRequiredDescription
propertiesobjectYesContact properties as JSON object. Must include at least one of: email, firstname, or lastname (e.g., {"email": "john@example.com", "firstname": "John", "lastname": "Doe"})
associationsarrayNoArray of associations to create with the contact as JSON. Each object should have "to.id" (company/deal ID) and "types" array with "associationCategory" and "associationTypeId"

Output

ParameterTypeDescription
contactobjectHubSpot contact record
emailstringContact email address
firstnamestringContact first name
lastnamestringContact last name
phonestringContact phone number
mobilephonestringContact mobile phone number
companystringAssociated company name
websitestringContact website URL
jobtitlestringContact job title
lifecyclestagestringLifecycle stage (subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer)
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
createdatestringContact creation date (ISO 8601)
lastmodifieddatestringLast modified date (ISO 8601)
addressstringStreet address
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
faxstringFax number
hs_timezonestringContact timezone
contactIdstringThe created contact ID
successbooleanOperation success status

hubspot_update_contact

Update an existing contact in HubSpot by ID or email

Input

ParameterTypeRequiredDescription
contactIdstringYesThe HubSpot contact ID (numeric string) or email of the contact to update
idPropertystringNoProperty to use as unique identifier (e.g., "email"). If not specified, uses record ID
propertiesobjectYesContact properties to update as JSON object (e.g., {"firstname": "John", "phone": "+1234567890"})

Output

ParameterTypeDescription
contactobjectHubSpot contact record
emailstringContact email address
firstnamestringContact first name
lastnamestringContact last name
phonestringContact phone number
mobilephonestringContact mobile phone number
companystringAssociated company name
websitestringContact website URL
jobtitlestringContact job title
lifecyclestagestringLifecycle stage (subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer)
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
createdatestringContact creation date (ISO 8601)
lastmodifieddatestringLast modified date (ISO 8601)
addressstringStreet address
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
faxstringFax number
hs_timezonestringContact timezone
contactIdstringThe updated contact ID
successbooleanOperation success status

hubspot_search_contacts

Search for contacts in HubSpot using filters, sorting, and queries

Input

ParameterTypeRequiredDescription
filterGroupsarrayNoArray of filter groups as JSON. Each group contains "filters" array with objects having "propertyName", "operator" (e.g., "EQ", "CONTAINS"), and "value"
sortsarrayNoArray of sort objects as JSON with "propertyName" and "direction" ("ASCENDING" or "DESCENDING")
querystringNoSearch query string to match against contact name, email, and other text fields
propertiesarrayNoArray of HubSpot property names to return (e.g., ["email", "firstname", "lastname", "phone"])
limitnumberNoMaximum number of results to return (max 100)
afterstringNoPagination cursor for next page (from previous response)

Output

ParameterTypeDescription
contactsarrayArray of HubSpot contact records
emailstringContact email address
firstnamestringContact first name
lastnamestringContact last name
phonestringContact phone number
mobilephonestringContact mobile phone number
companystringAssociated company name
websitestringContact website URL
jobtitlestringContact job title
lifecyclestagestringLifecycle stage (subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer)
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
createdatestringContact creation date (ISO 8601)
lastmodifieddatestringLast modified date (ISO 8601)
addressstringStreet address
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
faxstringFax number
hs_timezonestringContact timezone
pagingobjectPagination information for fetching more results
afterstringCursor for next page of results
linkstringLink to next page
metadataobjectResponse metadata
totalReturnednumberNumber of records returned in this response
hasMorebooleanWhether more records are available
totalnumberTotal number of matching contacts
successbooleanOperation success status

hubspot_list_companies

Retrieve all companies from HubSpot account with pagination support

Input

ParameterTypeRequiredDescription
limitstringNoMaximum number of results per page (max 100, default 100)
afterstringNoPagination cursor for next page of results (from previous response)
propertiesstringNoComma-separated list of HubSpot property names to return (e.g., "name,domain,industry")
associationsstringNoComma-separated list of object types to retrieve associated IDs for (e.g., "contacts,deals")

Output

ParameterTypeDescription
companiesarrayArray of HubSpot company records
namestringCompany name
domainstringCompany website domain (unique identifier)
descriptionstringCompany description
industrystringIndustry type (e.g., Airlines/Aviation)
phonestringCompany phone number
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
addressstringStreet address
numberofemployeesstringTotal number of employees
annualrevenuestringAnnual revenue estimate
lifecyclestagestringLifecycle stage
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
hs_createdatestringCompany creation date (ISO 8601)
hs_lastmodifieddatestringLast modified date (ISO 8601)
hs_additional_domainsstringAdditional domains (semicolon-separated)
num_associated_contactsstringNumber of associated contacts (auto-updated)
num_associated_dealsstringNumber of associated deals (auto-updated)
websitestringCompany website URL
pagingobjectPagination information for fetching more results
afterstringCursor for next page of results
linkstringLink to next page
metadataobjectResponse metadata
totalReturnednumberNumber of records returned in this response
hasMorebooleanWhether more records are available
successbooleanOperation success status

hubspot_get_company

Retrieve a single company by ID or domain from HubSpot

Input

ParameterTypeRequiredDescription
companyIdstringYesThe HubSpot company ID (numeric string) or domain to retrieve
idPropertystringNoProperty to use as unique identifier (e.g., "domain"). If not specified, uses record ID
propertiesstringNoComma-separated list of HubSpot property names to return (e.g., "name,domain,industry")
associationsstringNoComma-separated list of object types to retrieve associated IDs for (e.g., "contacts,deals")

Output

ParameterTypeDescription
companyobjectHubSpot company record
namestringCompany name
domainstringCompany website domain (unique identifier)
descriptionstringCompany description
industrystringIndustry type (e.g., Airlines/Aviation)
phonestringCompany phone number
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
addressstringStreet address
numberofemployeesstringTotal number of employees
annualrevenuestringAnnual revenue estimate
lifecyclestagestringLifecycle stage
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
hs_createdatestringCompany creation date (ISO 8601)
hs_lastmodifieddatestringLast modified date (ISO 8601)
hs_additional_domainsstringAdditional domains (semicolon-separated)
num_associated_contactsstringNumber of associated contacts (auto-updated)
num_associated_dealsstringNumber of associated deals (auto-updated)
websitestringCompany website URL
companyIdstringThe retrieved company ID
successbooleanOperation success status

hubspot_create_company

Create a new company in HubSpot

Input

ParameterTypeRequiredDescription
propertiesobjectYesCompany properties as JSON object (e.g., {"name": "Acme Inc", "domain": "acme.com", "industry": "Technology"})
associationsarrayNoArray of associations to create with the company as JSON (each with "to.id" and "types" containing "associationCategory" and "associationTypeId")

Output

ParameterTypeDescription
companyobjectHubSpot company record
namestringCompany name
domainstringCompany website domain (unique identifier)
descriptionstringCompany description
industrystringIndustry type (e.g., Airlines/Aviation)
phonestringCompany phone number
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
addressstringStreet address
numberofemployeesstringTotal number of employees
annualrevenuestringAnnual revenue estimate
lifecyclestagestringLifecycle stage
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
hs_createdatestringCompany creation date (ISO 8601)
hs_lastmodifieddatestringLast modified date (ISO 8601)
hs_additional_domainsstringAdditional domains (semicolon-separated)
num_associated_contactsstringNumber of associated contacts (auto-updated)
num_associated_dealsstringNumber of associated deals (auto-updated)
websitestringCompany website URL
companyIdstringThe created company ID
successbooleanOperation success status

hubspot_update_company

Update an existing company in HubSpot by ID or domain

Input

ParameterTypeRequiredDescription
companyIdstringYesThe HubSpot company ID (numeric string) or domain of the company to update
idPropertystringNoProperty to use as unique identifier (e.g., "domain"). If not specified, uses record ID
propertiesobjectYesCompany properties to update as JSON object (e.g., {"name": "New Name", "industry": "Finance"})

Output

ParameterTypeDescription
companyobjectHubSpot company record
namestringCompany name
domainstringCompany website domain (unique identifier)
descriptionstringCompany description
industrystringIndustry type (e.g., Airlines/Aviation)
phonestringCompany phone number
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
addressstringStreet address
numberofemployeesstringTotal number of employees
annualrevenuestringAnnual revenue estimate
lifecyclestagestringLifecycle stage
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
hs_createdatestringCompany creation date (ISO 8601)
hs_lastmodifieddatestringLast modified date (ISO 8601)
hs_additional_domainsstringAdditional domains (semicolon-separated)
num_associated_contactsstringNumber of associated contacts (auto-updated)
num_associated_dealsstringNumber of associated deals (auto-updated)
websitestringCompany website URL
companyIdstringThe updated company ID
successbooleanOperation success status

hubspot_search_companies

Search for companies in HubSpot using filters, sorting, and queries

Input

ParameterTypeRequiredDescription
filterGroupsarrayNoArray of filter groups as JSON. Each group contains "filters" array with objects having "propertyName", "operator" (e.g., "EQ", "CONTAINS"), and "value"
sortsarrayNoArray of sort objects as JSON with "propertyName" and "direction" ("ASCENDING" or "DESCENDING")
querystringNoSearch query string to match against company name, domain, and other text fields
propertiesarrayNoArray of HubSpot property names to return (e.g., ["name", "domain", "industry"])
limitnumberNoMaximum number of results to return (max 100)
afterstringNoPagination cursor for next page (from previous response)

Output

ParameterTypeDescription
companiesarrayArray of HubSpot company records
namestringCompany name
domainstringCompany website domain (unique identifier)
descriptionstringCompany description
industrystringIndustry type (e.g., Airlines/Aviation)
phonestringCompany phone number
citystringCity
statestringState/Region
zipstringPostal/ZIP code
countrystringCountry
addressstringStreet address
numberofemployeesstringTotal number of employees
annualrevenuestringAnnual revenue estimate
lifecyclestagestringLifecycle stage
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
hs_createdatestringCompany creation date (ISO 8601)
hs_lastmodifieddatestringLast modified date (ISO 8601)
hs_additional_domainsstringAdditional domains (semicolon-separated)
num_associated_contactsstringNumber of associated contacts (auto-updated)
num_associated_dealsstringNumber of associated deals (auto-updated)
websitestringCompany website URL
pagingobjectPagination information for fetching more results
afterstringCursor for next page of results
linkstringLink to next page
metadataobjectResponse metadata
totalReturnednumberNumber of records returned in this response
hasMorebooleanWhether more records are available
totalnumberTotal number of matching companies
successbooleanOperation success status

hubspot_list_deals

Retrieve all deals from HubSpot account with pagination support

Input

ParameterTypeRequiredDescription
limitstringNoMaximum number of results per page (max 100, default 100)
afterstringNoPagination cursor for next page of results (from previous response)
propertiesstringNoComma-separated list of HubSpot property names to return (e.g., "dealname,amount,dealstage")
associationsstringNoComma-separated list of object types to retrieve associated IDs for (e.g., "contacts,companies")

Output

ParameterTypeDescription
dealsarrayArray of HubSpot deal records
dealnamestringDeal name
amountstringDeal amount
dealstagestringCurrent deal stage
pipelinestringPipeline the deal is in
closedatestringExpected close date (ISO 8601)
dealtypestringDeal type (New Business, Existing Business, etc.)
descriptionstringDeal description
hubspot_owner_idstringHubSpot owner ID
hs_object_idstringHubSpot object ID (same as record ID)
createdatestringDeal creation date (ISO 8601)
hs_lastmodifieddatestringLast modified date (ISO 8601)
num_associated_contactsstringNumber of associated contacts
pagingobjectPagination information for fetching more results
afterstringCursor for next page of results
linkstringLink to next page
metadataobjectResponse metadata
totalReturnednumberNumber of records returned in this response
hasMorebooleanWhether more records are available
successbooleanOperation success status

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started