HubSpot

Connect to HubSpot CRM. Manage contacts, deals, companies, and marketing automation

Supports authentication: OAuth 2.0

Set up the agent connector

Register your Scalekit environment with the HubSpot connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

1. Set up auth redirects

   • In Scalekit dashboard, go to Agent Auth → Create Connection. Find HubSpot and click Create. Copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

   • Log in to your HubSpot developer dashboard, click Manage apps, and open your app.

   • Go to Auth → Auth settings → Redirect URL, paste the redirect URI, and click Save.

     

   • Select the required scopes for your application under Auth → Auth settings → Scopes.

     

2. Get client credentials

   • In your HubSpot App, go to Auth → Auth settings.

   • Copy your Client ID and Client Secret.

3. Add credentials in Scalekit

   • In Scalekit dashboard, go to Agent Auth → Connections and open the connection you created.

   • Enter your credentials:

     • Client ID (from above)
     • Client Secret (from above)
     • Permissions (scopes — see HubSpot API Scopes reference)

     Caution

     The scopes selected in your HubSpot app must exactly match the scopes you enter here. A mismatch will break the OAuth flow.

   • Click Save.

Tool list

hubspot_companies_search

Search HubSpot companies using full-text search and pagination. Returns matching companies with specified properties.

Name	Type	Required	Description
after	string	No	Pagination offset to get results starting from a specific position
filterGroups	string	No	JSON string containing filter groups for advanced filtering
limit	number	No	Number of results to return per page (max 100)
properties	string	No	Comma-separated list of properties to include in the response
query	string	No	Search term for full-text search across company properties

hubspot_company_create

Create a new company in HubSpot CRM. Requires a company name as the unique identifier. Supports additional properties like domain, industry, phone, location, and revenue information.

Name	Type	Required	Description
annualrevenue	number	No	Annual revenue of the company
city	string	No	Company city location
country	string	No	Company country location
description	string	No	Company description or overview
domain	string	No	Company website domain
industry	string	No	Industry type of the company
name	string	Yes	Company name (required, serves as primary identifier)
numberofemployees	number	No	Number of employees at the company
phone	string	No	Company phone number
state	string	No	Company state or region

hubspot_company_get

Retrieve details of a specific company from HubSpot by company ID. Returns company properties and associated data.

Name	Type	Required	Description
company_id	string	Yes	ID of the company to retrieve
properties	string	No	Comma-separated list of properties to include in the response

hubspot_contact_create

Create a new contact in HubSpot CRM. Requires an email address as the unique identifier. Supports additional properties like name, company, phone, and lifecycle stage.

Name	Type	Required	Description
company	string	No	Company name where the contact works
email	string	Yes	Primary email address for the contact (required, serves as unique identifier)
firstname	string	No	First name of the contact
hs_lead_status	string	No	Lead status of the contact
jobtitle	string	No	Job title of the contact
lastname	string	No	Last name of the contact
lifecyclestage	string	No	Lifecycle stage of the contact
phone	string	No	Phone number of the contact
website	string	No	Personal or company website URL

hubspot_contact_get

Retrieve details of a specific contact from HubSpot by contact ID. Returns contact properties and associated data.

Name	Type	Required	Description
contact_id	string	Yes	ID of the contact to retrieve
properties	string	No	Comma-separated list of properties to include in the response

hubspot_contact_update

Update an existing contact in HubSpot CRM by contact ID. Allows updating contact properties like name, email, company, phone, and lifecycle stage.

Name	Type	Required	Description
contact_id	string	Yes	ID of the contact to update
props	object	No	Object containing properties like first name, last name, email, company, phone, and job title to update all these should be provided inside props as a JSON object, this is required

hubspot_contacts_list

Retrieve a list of contacts from HubSpot with filtering and pagination. Returns contact properties and supports pagination through cursor-based navigation.

Name	Type	Required	Description
after	string	No	Pagination cursor to get the next set of results
archived	boolean	No	Whether to include archived contacts in the results
limit	number	No	Number of results to return per page (max 100)
properties	string	No	Comma-separated list of properties to include in the response

hubspot_contacts_search

Search HubSpot contacts using full-text search and pagination. Returns matching contacts with specified properties.

Name	Type	Required	Description
after	string	No	Pagination offset to get results starting from a specific position
filterGroups	string	No	JSON string containing filter groups for advanced filtering
limit	number	No	Number of results to return per page (max 100)
properties	string	No	Comma-separated list of properties to include in the response
query	string	No	Search term for full-text search across contact properties

hubspot_deal_create

Create a new deal in HubSpot CRM. Requires dealname, amount, and dealstage. Supports additional properties like pipeline, close date, and deal type.

Name	Type	Required	Description
amount	number	Yes	Deal amount/value (required)
closedate	string	No	Expected close date (YYYY-MM-DD format)
dealname	string	Yes	Name of the deal (required)
dealstage	string	Yes	Current stage of the deal (required)
dealtype	string	No	Type of deal
description	string	No	Deal description
hs_priority	string	No	Deal priority (HIGH, MEDIUM, LOW)
pipeline	string	No	Deal pipeline

hubspot_deal_update

Update an existing deal in HubSpot CRM by deal ID. Allows updating deal properties like name, amount, stage, pipeline, close date, and priority.

Name	Type	Required	Description
deal_id	string	Yes	ID of the deal to update
good_deal	boolean	No	Boolean flag indicating if this is a good deal
properties	object	Yes	Object containing deal properties to update

hubspot_deals_search

Search HubSpot deals using full-text search and pagination. Returns matching deals with specified properties.

Name	Type	Required	Description
after	string	No	Pagination offset to get results starting from a specific position
filterGroups	string	No	JSON string containing filter groups for advanced filtering
limit	number	No	Number of results to return per page (max 100)
properties	string	No	Comma-separated list of properties to include in the response
query	string	No	Search term for full-text search across deal properties