Skip to main content
HubSpot is a CRM and customer platform for sales, marketing, and service teams. The HubSpot shared connector lets your Lovable app call the HubSpot CRM APIs through Lovable’s connector gateway, using a HubSpot service key (private app token) so secrets are not embedded in your project source. With HubSpot connected, your app can:
  • Access and manage CRM contacts, companies, and deals
  • Create and track pipelines and deal stages
  • Support marketing workflows and email-related automation (within what your key and HubSpot plan allow)
  • Retrieve reporting and analytics data where exposed by the API
  • Work with tickets and customer service objects
HubSpot is a strong fit when your source of truth for leads and customers is already in HubSpot and you want your Lovable app to read or update that data in real time.

Common use cases and example apps

Example appExample promptDescription
Lead inboxBuild an internal view of new HubSpot contacts created this week with owner and lifecycle stage.Give teams a focused list without opening HubSpot for every lookup.
The app queries contacts and renders filters your team cares about.
Deal pipeline boardBuild a Kanban-style board of deals by stage for our European pipeline.Visualize pipeline health from CRM data.
The app loads deals and groups them by stage for quick standups.
Account lookupBuild a tool where I enter a company domain and see HubSpot company info and related contacts.Connect account research to CRM records.
The app looks up companies and associated contacts in one place.
Support snapshotBuild a page that shows open tickets for a customer when I paste their HubSpot company ID.Tie your app’s workflows to service data.
The app fetches tickets (or summaries) for context during calls or reviews.
Marketing list syncBuild a workflow that adds a contact to a static list when they submit a form in our app.Keep marketing lists aligned with product actions.
The app calls HubSpot when events happen in your UI (subject to API and consent rules).
Sales handoffWhen a lead hits MQL in HubSpot, show their full contact card and last five activities in our handoff app.Prepare sales with CRM context.
The app aggregates contact and engagement data for a single view.
What you can build depends on HubSpot scopes tied to your service key, your HubSpot subscription, and your org’s data model (custom properties, pipelines, etc.).

How to connect HubSpot

Workspace admins and owners can connect HubSpot. When a connection is created, HubSpot becomes available across projects in the workspace according to your linked projects settings.

Prerequisites

Before connecting HubSpot, make sure you have:
  • A HubSpot account with permission to create or manage private apps (or otherwise issue a service key)
  • The HubSpot portal you want this connection to use
  • Lovable workspace admin or owner role
HubSpot API access, rate limits, and product features depend on your HubSpot plan and HubSpot’s fair-use policies. Usage is billed by HubSpot according to your agreement with them, not by Lovable.

Step 1: Create a HubSpot service key

HubSpot authenticates server-to-server API calls with a service key (access token) from a private app (or equivalent in your HubSpot setup).
  1. Open your HubSpot account and go to Development (or Settings → Integrations → Private apps, depending on your HubSpot UI).
  2. Create a private app (or open an existing one) used for Lovable.
  3. Assign the scopes your app will need—only grant what you intend to use (for example contacts read/write, deals read, tickets read).
  4. Create or copy the access token. It must start with pat-.
For HubSpot’s official steps and security guidance, see Account service keys and private apps.
Treat the service key like a password. If it leaks, revoke it in HubSpot and create a new one.

Step 2: Connect HubSpot in Lovable

  1. Go to Settings → Connectors → Shared connectors and select HubSpot.
  2. Click Add connection.
  3. In Display name, enter a clear name (for example HubSpot Production or HubSpot Sandbox).
  4. In Service key, paste the HubSpot access token (must match the pat-… format).
  5. Click Create (or Save).
Lovable verifies the key against HubSpot. When the connection is active, you can describe CRM features in chat and link the connection to projects that should use it.

Limitations

  • Scopes are fixed at key creation — if you need new permissions, update the private app in HubSpot and replace the service key in Lovable (or create a new connection).
  • End-user HubSpot login (each visitor signing into their own HubSpot) is separate from this shared connector, which represents one portal connection for your workspace.
  • Gateway limits and HubSpot’s own rate limits both apply; design high-volume jobs with batching and caching where appropriate.
Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:
1

Navigate to connectors

Go to Settings → Connectors → Shared connectors and select .
2

Open the connection

Open the connection you want to manage.
3

Select projects

Under Linked projects, check the projects you want to unlink.
4

Confirm

Click Unlink projects and confirm.
When unlinked, those projects will no longer have access to through this connection. If a project needs again, you can link it to any available connection.

How to delete a connection

Workspace admins and owners can delete connections.
Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
Before deleting, review the Linked projects section to see which projects are currently using the connection. To delete a connection:
1

Navigate to connectors

Go to Settings → Connectors → Shared connectors and select .
2

Open the connection

Open the connection you want to remove.
3

Review linked projects

Review the Linked projects section.
4

Delete

Under Delete this connection, click Delete and confirm.