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.

Authentication: OAuth Category: CRM & Customer Support Availability: All workspace plans

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

• Data Management Manage and organize your HubSpot data

• Automation Automate workflows with HubSpot

• Reporting Generate insights and reports

• Integration Connect HubSpot with other tools

Best Practices

1

Getting Started

• Enable the HubSpot integration in your workspace settings

• Authenticate using OAuth

• Test the connection with a simple read operation

• Explore available actions for your use case

2

Important Considerations

• Ensure proper authentication credentials

• Respect rate limits and API quotas

• Review data privacy settings

• Test operations in a safe environment first

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 [email protected]