Documentation Index
Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
Use this file to discover all available pages before exploring further.
What is HubSpot and Why Use This Integration?
HubSpot is a CRM platform used to manage contacts, deals, companies, and marketing automations. When you connect HubSpot to a LanderLab landing page, every lead that submits your form is instantly created as a contact in HubSpot, with all the form fields you choose mapped to the correct HubSpot contact properties. HubSpot uses OAuth to connect. This means instead of pasting an API key, you log in to your HubSpot account directly and authorize LanderLab to access it. You will be redirected to HubSpot to complete the authorization, then brought back to LanderLab to finish the setup.HubSpot integrations are saved globally in your account. Once you authorize your HubSpot account, you can reuse it across multiple landing pages without going through the OAuth flow again.
How to Add HubSpot
The HubSpot setup has two phases: authorizing your HubSpot account via OAuth, then configuring your field mapping inside LanderLab.Phase 1: Authorize Your HubSpot Account
Go to your landing page
Navigate to Landing Pages and click the name of the landing page where you want to add HubSpot.
Sign in to HubSpot
On the HubSpot authorization page you have two options:
- Sign in to your HubSpot account - use this if you already have a HubSpot account
- Create a new HubSpot account - use this if you do not have one yet
Authorize LanderLab
After logging in, HubSpot will show a permissions screen listing what LanderLab is requesting access to, including the ability to manage and view your CRM data such as contacts, companies, and deals.Review the permissions and click Connect to authorize LanderLab.
LanderLab requests CRM access so it can create and update contact records in HubSpot when a lead is submitted. You can revoke this access at any time from your HubSpot account under Settings > Integrations > Connected Apps.
Phase 2: Configure Field Mapping
Once you are back in LanderLab after the OAuth redirect, you will go through a 3-step wizard to finish the setup.Step 1: Configure the Connection
Set a name for this integration
Give this integration a recognizable label (e.g. “HubSpot - Auto Insurance Leads”). This helps you identify it in the integrations list on your landing page.
Step 2: Map Your Fields
Map your form fields to HubSpot contact properties
You will see a list of all fields from your landing page form on the left, and a dropdown to select the matching HubSpot contact property on the right.Map each form field to the corresponding HubSpot property. At minimum, map Email as it is required by HubSpot to create or update a contact.
Fields you do not map will not be sent to HubSpot. Use the checkboxes on the left to include or exclude individual fields.
| Form Field | HubSpot Property |
|---|---|
| Full Name | Full Name |
| Email* | |
| Phone Number | Phone Number |
| (other form fields) | Select field |
Step 3: Review and Connect
Review your integration
The final step shows a full summary of your HubSpot integration including the integration name and all mapped fields. Review everything carefully before activating.If anything looks wrong, click Back to return to the previous steps and make changes.
Tips for HubSpot Integration
- Email is required - HubSpot uses email as the unique identifier for contacts. Always map the email field and make sure your form includes an email input.
- Existing contacts are updated - If a lead submits with an email address that already exists in HubSpot, LanderLab will update the existing contact record rather than creating a duplicate.
- Map phone carefully - HubSpot has a specific Phone Number property. Make sure you map your form’s phone field to the correct HubSpot property to avoid data ending up in the wrong place.
- Test with a real submission - After connecting, submit a test lead on your landing page and verify the contact appears in HubSpot under Contacts within a few seconds.
- Re-authorizing - If you ever need to reconnect your HubSpot account, simply add a new HubSpot integration and go through the OAuth flow again.