Skip to main content

​
At a glance

  • Availability: Enabled by default.
  • Auth: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: oauth, crm.objects.contacts.read.
  • Optional scopes: forms, crm.objects.leads.read, crm.objects.leads.write.

​
Credentials

Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.
VariableRequiredDescription
HUBSPOT_CLIENT_IDYesHubSpot OAuth Client ID Docs.
HUBSPOT_CLIENT_SECRETYesHubSpot OAuth Client Secret Docs.

​
Tools

ToolAccessDescription
List FormsReadList HubSpot forms so agents can find a form ID before reading submissions
List Form SubmissionsReadList recent submissions for a HubSpot form in reverse chronological order
Get ContactReadGet a HubSpot contact by ID or email before scoring, dedupe, or updates
Search ContactsReadSearch HubSpot contacts by filters for lead research and CRM lookup
Create ContactWriteCreate a HubSpot contact from form submission or researched lead data
Update ContactWriteUpdate HubSpot contact properties, including lead score or research notes
Get LeadReadGet a HubSpot CRM lead before scoring, routing, or updates
List LeadsReadList HubSpot CRM leads for scoring, spreadsheet updates, or research workflows
Search LeadsReadSearch HubSpot CRM leads for dedupe, scoring, and routing workflows
Create LeadWriteCreate a HubSpot CRM lead associated with an existing contact or company
Update LeadWriteUpdate a HubSpot CRM lead with score, qualification, owner, or research fields
Get CompanyReadGet a HubSpot company by ID or domain before lead research or association
Search CompaniesReadSearch HubSpot companies by domain, name, or firmographic properties
Create CompanyWriteCreate a HubSpot company for researched lead accounts
Update CompanyWriteUpdate HubSpot company properties with research or enrichment data
List PropertiesReadList HubSpot CRM properties for contacts, leads, or companies before updating custom fields
List OwnersReadList HubSpot owners so agents can assign or route contacts and leads
List Association LabelsReadList HubSpot association labels between CRM object types before associating records
List AssociationsReadList records associated with a HubSpot CRM record
Associate RecordsWriteCreate a default HubSpot association between two CRM records
Remove AssociationWriteRemove all HubSpot associations between two CRM records

​
Example prompts

  • List recent HubSpot form submissions, identify the strongest leads, and summarize recommended follow-up.
  • Research HubSpot contacts or leads, score them, and update the matching CRM records.