IntegrationsSalesHubspot

Hubspot

Description: Enable agents to interact with the Hubspot CRM.

Author: Arcade

Code: GitHub

Auth: OAuth 2.0

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Arcade Hubspot toolkit provides a pre-built set of tools for interacting with the Hubspot CRM. These tools make it easy to build agents and AI apps that can:

  • Search and retrieve company data and associated objects (deals, calls, email messages, etc)
  • Search and retrieve contact data and associated objects (calls, email messages, notes, tasks, etc)
  • Create contacts

Install

pip install arcade_hubspot

pip installing the toolkit is only needed if you are self-hosting Arcade. You do not need to install the toolkit if you’re using Arcade Cloud.

Available Tools

Tool NameDescription
GetCompanyDataByKeywordsRetrieve data about companies in Hubspot using full-text search.
GetContactDataByKeywordsRetrieve data about contacts in Hubspot using full-text search.
CreateContactCreate a contact in Hubspot.

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.

GetCompanyDataByKeywords


Retrieve company data with associated contacts, deals, calls, emails, meetings, notes, and tasks.

Parameters

  • keywords (string, required) The keywords to search for companies. It will match against the company name, phone, and website.
  • limit (int, optional, Defaults to 10) The maximum number of companies to return. Defaults to 10. Max is 10.
  • next_page_token (string, optional) The token to get the next page of results. Defaults to None (returns first page of results)

GetContactDataByKeywords


Retrieve contact data with associated companies, deals, calls, emails, meetings, notes, and tasks.

Parameters

  • keywords (string, required) The keywords to search for. E.g. ‘quarterly report’
  • limit (int, optional, Defaults to 10) The maximum number of contacts to return. Defaults to 10. Max is 10.
  • next_page_token (string, optional) The token to get the next page of results. Defaults to None (returns first page of results)

CreateContact


Create a contact associated with a company.

Parameters

  • company_id (string, required) The ID of the company to create the contact for.
  • first_name (string, required) The first name of the contact.
  • last_name (string, optional) The last name of the contact.
  • email (string, optional) The email address of the contact.
  • phone (string, optional) The phone number of the contact.
  • mobile_phone (string, optional) The mobile phone number of the contact.
  • job_title (string, optional) The job title of the contact.

Auth

The Arcade Hubspot toolkit uses the Hubspot auth provider to connect to users’ Hubspot accounts.

Arcade Cloud

The Arcade Cloud offers a default Hubspot auth provider. If you use it, there’s nothing to configure. Your users will see Arcade as the name of the application requesting permission.

Alternatively, you can configure a custom Hubspot auth provider with your own Hubspot app credentials. This way, your users will see your application’s name requesting permission.

Self-hosted Arcade Engine

With a self-hosted installation of Arcade, you must configure the Hubspot auth provider with your own Hubspot app credentials.

YoutubeContribute a toolkit