How to Connect HubSpot CRM Forms to Form2Lead
Step-by-step developer instructions for HubSpot CRM applications.
How do you send HubSpot CRM form submissions to Form2Lead?
Form2Lead integrates directly with HubSpot CRM using HubSpot’s public Forms API v3 endpoint (`api.hsforms.com/submissions/v3/integration/submit/{portalId}/{formGuid}`) and native HubSpot format preset. Form fields map automatically to HubSpot contact properties with no OAuth or Zapier required.
Why use Form2Lead with HubSpot CRM?
Capture leads on static sites or custom frontend frameworks and pipe them directly into HubSpot CRM. Form2Lead formats inputs into HubSpot’s expected `fields: [{ name, value }]` specification, allowing you to trigger HubSpot workflows, lifecycle stage updates, and sales rep assignments automatically.
Prerequisites
- ✔A HubSpot account (Free or paid)
- ✔Your HubSpot Portal ID (Hub ID) and Form GUID
- ✔A Form2Lead form endpoint
Step-by-Step Integration Guide
01. Find Your HubSpot Portal ID & Form GUID
In HubSpot, navigate to Marketing → Forms, create or open a form, and copy your Portal ID (top right of your HubSpot dashboard) and Form GUID from the form embed code.
02. Construct the Submission URL
Combine your IDs into HubSpot’s standard v3 submission URL:
https://api.hsforms.com/submissions/v3/integration/submit/{portalId}/{formGuid}03. Add to Form2Lead & Auto-Detect
Paste the URL into Form2Lead. The system auto-detects "HubSpot Forms API" and serializes fields into HubSpot properties on every submission.
04. (Optional) Authenticate with Private App Tokens
If targeting a private HubSpot API endpoint, use Form2Lead’s Custom Headers editor to add "Authorization: Bearer YOUR_HUBSPOT_TOKEN".
HubSpot CRM Integration FAQ
Do I need OAuth or a paid HubSpot tier for form capture?
No. The HubSpot Forms API v3 endpoint accepts submissions publicly using your Portal ID and Form GUID, exactly like embedded HubSpot forms, without OAuth overhead.
Which HubSpot properties are supported?
Any standard or custom property: email, firstname, lastname, phone, company, message, or custom fields with matching internal property names.