{/* 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.
Setup
- 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.
- Create a public app: In a HubSpot developer account, create an app that uses OAuth.
- 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.
- 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.
Tools
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.