HubSpot

​

Overview

All-in-one platform that integrates marketing, sales, and customer service software. Through Langdock’s integration, you can access and manage HubSpot directly from your conversations.

​

Available Actions

​

Create Contact

hubspot.createContact

Creates a new contact in HubSpot Requires Confirmation: Yes Parameters:

• additionalProperties (TEXT, Optional): Any custom properties specific to your HubSpot account
  • firstName (TEXT, Optional): The contact’s first name
  • company (TEXT, Optional): The name of the company the contact works for
  • zip (TEXT, Optional): ZIP-Code of the contact
  • jobtitle (TEXT, Optional): The contact’s job title
  • address (TEXT, Optional): Address of the contact
  • country (TEXT, Optional): Country of the contact
  • website (TEXT, Optional): Link to a personal profile of the contact or of the company
  • leadStatus (TEXT, Optional): The current status of a lead in the sales pipeline
  • email (TEXT, Required): The contact’s email address
  • lastName (TEXT, Optional): The contact’s last name
  • owner (TEXT, Optional): HubSpot owner ID of the responsible person for that contact
  • phone (TEXT, Optional): The contact’s phone number
  • lifecycleStage (TEXT, Optional): The lifecycle stage of a contact or company
  • state (TEXT, Optional): State of the contact (within their country)
  • leadSource (TEXT, Optional): The source from which the lead originated in HubSpot
  • associations (TEXT, Optional): Links between this contact and other HubSpot objects

Output: Returns the created contact with ID and all specified properties

---

​

Create Company

hubspot.createCompany

Creates a new company in HubSpot Requires Confirmation: Yes Parameters:

• associations (TEXT, Optional): Associations to other objects (contacts, meeting, notes, deals etc.)
  • city (TEXT, Optional): The city where the company’s primary office or headquarters is located
  • industry (TEXT, Optional): The sector or industry the company operates in
  • address (TEXT, Optional): The street address of the company’s primary location
  • name (TEXT, Required): Company name
  • country (TEXT, Optional): The country where the company is based
  • domain (TEXT, Optional): The company’s website domain without protocol or paths
  • additionalProperties (TEXT, Optional): Any custom properties specific to your HubSpot account
  • description (TEXT, Optional): A brief overview of the company, its mission, products, or services
  • ownerId (TEXT, Optional): The HubSpot user ID of the person responsible for managing this company record
  • website (TEXT, Optional): The full URL of the company’s website
  • phone (TEXT, Optional): The main contact phone number for the company
  • state (TEXT, Optional): The state, province, or region where the company is located

Output: Returns the created company with ID and all specified properties

---

​

Create Deal

hubspot.createDeal

Creates a new deal in HubSpot Requires Confirmation: Yes Parameters:

• associatedObjects (MULTI_LINE_TEXT, Optional): Associations to other objects (contacts, companies, etc.)
  • closeDate (TEXT, Optional): The expected close date of the deal (Format: ISO 8601)
  • additionalProperties (TEXT, Optional): Any additional custom properties you want to set
  • stage (TEXT, Optional): The stage of the deal in the pipeline
  • dealOwner (TEXT, Optional): User ID of the HubSpot user responsible for this deal
  • amount (NUMBER, Optional): The monetary value of the deal
  • dealName (TEXT, Required): The name of the deal/opportunity
  • pipeline (TEXT, Required): The pipeline the deal belongs to
  • description (TEXT, Optional): A description of the deal

Output: Returns the created deal with ID and all specified properties

---

​

Create Note

hubspot.createNote

Creates a note that an object can be associated with Requires Confirmation: No Parameters:

• ownerId (TEXT, Required): Owner ID of the HubSpot user creating the note
  • noteBody (TEXT, Required): Text for the note
  • attachmentIds (TEXT, Optional): If you want to put a single or multiple attachments onto the note
  • associations (TEXT, Required): A comma-separated list of object type and ID pairs

Output: Returns the created note with ID and association details

---

​

Update Contact

hubspot.updateContact

Updates a contact in HubSpot Requires Confirmation: No Parameters:

• properties (TEXT, Required): Properties to update on the HubSpot contact (JSON string)
  • contactId (TEXT, Required): ID of the contact that should be updated

Output: Returns the updated contact with new property values

---

​

Update Company

hubspot.updateCompany

Updates a company in HubSpot Requires Confirmation: No Parameters:

• companyId (TEXT, Optional): ID of the company that should be updated
  • properties (TEXT, Optional): The properties parameter expects a JSON object containing company property values to update

Output: Returns the updated company with new property values

---

​

Update Deal

hubspot.updateDeal

Updates one or more fields from an existing deal Requires Confirmation: No Parameters:

• properties (MULTI_LINE_TEXT, Required): Properties to update on the HubSpot deal (JSON string)
  • dealId (TEXT, Required): ID of the deal that should be updated

Output: Returns the updated deal with new property values

---

​

Get Contact

hubspot.getContact

Gets a contact by its ID Requires Confirmation: No Parameters:

• contactId (TEXT, Required): ID of the contact to get

Output: Returns contact details including all properties and associations

---

​

Get Contact Engagement

hubspot.getContactEngagement

Retrieve engagement information like recent activities of a contact Requires Confirmation: No Parameters:

• id (TEXT, Required): The ID of the object to retrieve engagement from

Output: Returns engagement information including recent activities and interactions

---

​

Get Company

hubspot.getCompany

Gets a company by its ID Requires Confirmation: No Parameters:

• companyId (TEXT, Required): ID of the company to get

Output: Returns company details including all properties and associations

---

​

Get Deal

hubspot.getDeal

Gets a deal by its ID Requires Confirmation: No Parameters:

• dealId (TEXT, Required): ID of the deal to get

Output: Returns deal details including all properties and associations

---

​

Get Deal Context

hubspot.getDealContext

Gets all required information on the custom deal object, available pipelines, and more Requires Confirmation: No Parameters: None Output: Returns deal context information including available pipelines and custom properties

---

​

Find Contact

hubspot.findContact

Finds a contact by searching Requires Confirmation: No Parameters:

• limit (TEXT, Optional): Maximum number of records to return in a single request
  • properties (TEXT, Optional): Specifies which contact properties to include in the response
  • searchQuery (TEXT, Optional): A text string for full-text search across all searchable properties
  • filterGroups (TEXT, Optional): Allows you to create complex filtering logic to narrow down contact search results
  • sorts (TEXT, Optional): Defines how results should be ordered

Output: Returns array of contacts matching the search criteria

---

​

Find Company

hubspot.findCompany

Finds a company by searching Requires Confirmation: No Parameters:

• searchQuery (TEXT, Optional): A text string for full-text search across all searchable properties
  • properties (TEXT, Optional): Specifies which company properties to include in the response
  • sorts (TEXT, Optional): Defines how company search results should be ordered
  • limit (NUMBER, Optional): Maximum number of records to return in a single request
  • filterGroups (TEXT, Optional): Allows you to create complex filtering logic to narrow down company search results

Output: Returns array of companies matching the search criteria

---

​

Find Deal

hubspot.findDeal

Finds a deal by searching Requires Confirmation: No Parameters:

• limit (NUMBER, Optional): Maximum number of records to return in a single request
  • searchQuery (TEXT, Optional): A text string for full-text search across all searchable properties
  • filterGroups (TEXT, Optional): Allows you to create complex filtering logic to narrow down search results
  • properties (TEXT, Optional): Specifies which deal properties to include in the response
  • sorts (TEXT, Optional): Defines how results should be ordered

Output: Returns array of deals matching the search criteria

---

​

Get HubSpot Owners

hubspot.getHubSpotOwners

Retrieves all HubSpot owners/users with optional filtering by email Requires Confirmation: No Parameters:

• email (TEXT, Optional): Search for a specific owner by their email address
  • limit (NUMBER, Optional): Maximum number of owners to retrieve (default 100, maximum 500)
  • includeInactive (BOOLEAN, Optional): Whether to include archived/inactive owners in the results

Output: Returns array of owners with their IDs, emails, and other details

---

​

Get Current User Context

hubspot.getCurrentUserContext

Gets the current user’s email, hubspot_owner_id, and other important info Requires Confirmation: No Parameters: None Output: Returns current user context including email and owner ID

---

​

Common Use Cases

​

Best Practices

​

Troubleshooting

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

​

Support

For additional help with the HubSpot integration, contact support@langdock.com