HubSpot

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Enabled by default.
  • Authentication: 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.

These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

VariableRequiredDescription
HUBSPOT_CLIENT_IDYesHubSpot OAuth Client ID Docs.
HUBSPOT_CLIENT_SECRETYesHubSpot OAuth Client Secret Docs.

Setup

  1. Choose who owns the HubSpot OAuth app: On hosted Veryfront, HubSpot uses the Veryfront-managed HubSpot OAuth app: connect HubSpot from the project's integrations and approve the HubSpot consent screen, no environment variables needed. Set HUBSPOT_CLIENT_ID and HUBSPOT_CLIENT_SECRET only to use your own HubSpot OAuth app, which is required for local and self-hosted runs.
  2. Create a public app: In a HubSpot developer account, create an app that uses OAuth.
  3. Set the redirect URL and scopes: Add oauth and crm.objects.contacts.read as required scopes and forms, crm.objects.leads.read and crm.objects.leads.write as optional scopes. Add the redirect URI of the environment that completes the flow: https://api.veryfront.com/oauth/callback/hubspot for hosted Veryfront, or your app origin followed by /oauth/callback/hubspot for a local or self-hosted app. Set HUBSPOT_CLIENT_ID and HUBSPOT_CLIENT_SECRET from the app's credentials.
  4. Verify access: Run Search Contacts (read-only). It returns contacts from the connected HubSpot account without changing them.

Provider notes

  • The connection requests oauth and crm.objects.contacts.read. The optional scopes forms, crm.objects.leads.read and crm.objects.leads.write are granted only when the installing account has access to them; the form and lead tools need them.
  • Tools that create, update, send or delete data are marked as writes and need write authority; the other tools are read-only.

Provider API reference.

Tools

ToolAccessDescription
List Forms<br /><code className="reference-identifier">hubspot__list_forms</code>ReadList forms
List Form Submissions<br /><code className="reference-identifier">hubspot__list_form_submissions</code>ReadList form submissions
Get Contact<br /><code className="reference-identifier">hubspot__get_contact</code>ReadGet contact
Search Contacts<br /><code className="reference-identifier">hubspot__search_contacts</code>ReadSearch contacts
Create Contact<br /><code className="reference-identifier">hubspot__create_contact</code>WriteCreate contact
Update Contact<br /><code className="reference-identifier">hubspot__update_contact</code>WriteUpdate contact
Get Lead<br /><code className="reference-identifier">hubspot__get_lead</code>ReadGet lead
List Leads<br /><code className="reference-identifier">hubspot__list_leads</code>ReadList leads
Search Leads<br /><code className="reference-identifier">hubspot__search_leads</code>ReadSearch leads
Create Lead<br /><code className="reference-identifier">hubspot__create_lead</code>WriteCreate lead
Update Lead<br /><code className="reference-identifier">hubspot__update_lead</code>WriteUpdate lead
Get Company<br /><code className="reference-identifier">hubspot__get_company</code>ReadGet company
Search Companies<br /><code className="reference-identifier">hubspot__search_companies</code>ReadSearch companies
Create Company<br /><code className="reference-identifier">hubspot__create_company</code>WriteCreate company
Update Company<br /><code className="reference-identifier">hubspot__update_company</code>WriteUpdate company
List Properties<br /><code className="reference-identifier">hubspot__list_properties</code>ReadList properties
List Owners<br /><code className="reference-identifier">hubspot__list_owners</code>ReadList owners
List Association Labels<br /><code className="reference-identifier">hubspot__list_association_labels</code>ReadList association labels
List Associations<br /><code className="reference-identifier">hubspot__list_associations</code>ReadList associations
Associate Records<br /><code className="reference-identifier">hubspot__associate_records</code>WriteAssociate records
Remove Association<br /><code className="reference-identifier">hubspot__remove_association</code>WriteRemove all associations between records

Verify the connection

Call a read tool such as hubspot__list_forms with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.