HubSpot is a customer relationship management (CRM) platform for managing contacts, companies, deals, and support tickets. When connected, your Lovable apps can read and write CRM data, automate workflows, and build internal tools or dashboards on top of your HubSpot account. With HubSpot, your app can:Documentation Index
Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
Use this file to discover all available pages before exploring further.
- Access and manage CRM contacts, companies, and deals
- Create and track sales pipelines and deal stages
- Automate CRM workflows and sales processes
- Retrieve analytics and reporting data
- Manage tickets and customer service interactions
Common use cases and example apps
| Example app | Example prompt | Description |
|---|---|---|
| Lead capture forms | Build a lead capture form. Use HubSpot to create or update a contact when someone submits their name, email, and company. | Capture leads directly into your CRM so new contacts appear immediately in HubSpot. User submits a form, and the app creates or updates a contact record in HubSpot with the provided details so the sales team can follow up. |
| Sales pipeline dashboards | Build a sales pipeline dashboard. Use HubSpot to pull open deals, group them by stage, and add filters for owner and close date. | Visualize sales pipeline activity using data from HubSpot. The app retrieves deal records from HubSpot, groups them by pipeline stage, and lets users filter the results to understand pipeline health and progress. |
| CRM management tools | Build a CRM management tool. Use HubSpot to display contacts and deals and allow editing key fields directly from the app. | Manage CRM records through a simplified internal interface. The app retrieves contacts and deals from HubSpot, displays them in editable tables or forms, and writes updates back to the CRM. |
| Support ticket trackers | Build a support ticket tracker. Use HubSpot to pull open tickets and allow agents to update status and add notes. | Manage customer support tickets through a simplified interface. The app retrieves ticket records from HubSpot, displays them in a filterable list, and lets agents update ticket properties while syncing changes back to the CRM. |
| Contact enrichment tools | Build a contact enrichment tool. Use HubSpot to update contacts with additional company information or attributes. | Enrich CRM contact records with additional company information. User selects a contact or enters a company domain, and the app updates the HubSpot contact record with attributes such as company size, industry, or website details. |
| CRM-powered client portals | Build a client portal. Use HubSpot to retrieve company information, deal status, and ticket history for each logged-in customer. | Provide clients with visibility into their projects and support activity. User logs in to a portal where the app retrieves company, deal, and ticket records from HubSpot and displays them in a secure dashboard. |
| Deal notifications and alerts (HubSpot + Slack) | Build a deal notification workflow. Use HubSpot to detect when deals move to “Closed Won” and send a message to a Slack channel. | Notify the team about important pipeline events automatically. The app monitors deal stage changes in HubSpot and posts formatted alerts to Slack so the team stays informed about new deals and milestones. |
How to connect HubSpot
Workspace admins and owners can connect HubSpot. You can create multiple HubSpot connections using different service keys. This is useful for separating environments (for example, development and production) or limiting access through scoped permissions. When the connection is created, HubSpot becomes available across all projects in the workspace.Prerequisites
Before connecting HubSpot, make sure you have:- A HubSpot account with super admin access or developer tools permissions (required to create service keys)
- A HubSpot service key
- Lovable workspace owner or admin role
All API requests made through this connector count toward your HubSpot API usage limits. Limits depend on your HubSpot subscription and are managed by HubSpot, not Lovable.
Step 1: Create a HubSpot service key
A service key allows Lovable to securely access your HubSpot account through the HubSpot API. To create a HubSpot service key:- Go to HubSpot and set up your account.
- Navigate to Development → Keys → Service keys.
- Click Create service key.
- Enter a descriptive name, for example
Lovable integration. - Click Add new scope and select the scopes your app needs. For example:
crm.objects.contacts.readandcrm.objects.contacts.writecrm.objects.deals.readandcrm.objects.deals.write
- Click Update after selecting scopes and review the selected scopes.
- Click Create, then confirm in the dialog box.
- Open the service key you created, and click Show to reveal the key.
- Click Copy to copy it to your clipboard.
Your service key functions like a password. Keep it secure and never share it publicly. You’ll need it in the next step.
Step 2: Connect HubSpot to Lovable
You can create multiple connections using different service keys. To connect HubSpot:- Go to Connectors → App connectors and select HubSpot.
- Click Add connection.
- Display name: name the connection, for example
HubSpot Prod. - Service key: enter your HubSpot service key (
pat-xxxx…). - Who can access this connection: keep access limited to specific people or invite entire workspace. See Connection-level access for more information.
- Click Connect.
Limitations
The HubSpot connector uses service keys for authentication, which support REST API requests only. Service keys cannot:- Receive HubSpot webhooks or event subscriptions
- Authenticate calls within HubSpot UI extensions
How to unlink projects from a connection
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:
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.