Every time you create a form in HubSpot, the system gives it a globally unique identifier, its GUID. Think of it as the form’s digital fingerprint. HubSpot uses the GUID internally to keep that specific form tied to submissions, automations, and reports.
You’ll need the GUID anytime you connect forms with external systems, embed them on non-HubSpot sites, or make API calls involving submissions. Unlike the form name or layout, the GUID never changes, even if you rename or update the form, making it an important fixed reference across your tech stack.
You won’t see the GUID displayed by default. To find it, you’ll either need to open the form’s embed code or inspect backend details.
You’ll use it most often in:
- The Forms tool when managing or sharing forms
- HubSpot’s Forms API, where the GUID is required for submissions
- Workflows triggered by form activity
- Reports filtered by form-specific conversions
If you’re syncing data upstream or embedding multiple forms across different environments, properly identifying and managing GUIDs helps ensure submissions don’t get lost in the shuffle.
How It Works Under the Hood
Behind every HubSpot form is a GUID that links submissions to your portal and automation logic. Understanding how it powers data flow can save you hours troubleshooting issues later.
Here’s what happens step by step:
- Form creation: When you add a new form in HubSpot, a GUID is automatically generated.
- Form storage: That GUID links your form to its backend submission endpoint.
- Form embed: Embedding the form? HubSpot uses the GUID in the embed script to determine where submissions go.
- Data handling: When someone hits submit, HubSpot logs the data to the correct form by matching the GUID.
- API communication: Any API call that involves a form submission, update, or retrieval will use the GUID to identify the right asset.
Even if your form includes conditional logic or progressive fields, the same GUID applies throughout. HubSpot anchors all variations back to that core ID, making your GUID a constant across all display or field configurations.
Main Uses Inside HubSpot
Embedding HubSpot Forms Externally
If your marketing site or landing pages live outside HubSpot, you’ll likely embed HubSpot forms to capture leads. The GUID in the embed code tells HubSpot exactly which form to load and where to send the data.
Example:
You’re building a lead generation page on WordPress. After finalizing your contact form in HubSpot, you grab the embed code. That script contains the form’s GUID, which your developer adds to the page. When a visitor fills it out, HubSpot uses the GUID to process the submission in your account.
Leave out or misplace the GUID, and the form won’t submit, or worse, it sends data to the wrong place.
Connecting to the HubSpot Forms API
If you’re integrating HubSpot with third-party tools or custom applications, you’ll need the Form GUID to authenticate form data through the API.
Example:
Let’s say you’ve created a custom-built form in a React app. To send submissions into HubSpot, your system needs to call the Forms API. That request must include your account’s portal ID and the correct form GUID. Without it, the submission fails or gets lost.
Knowing exactly which form GUID belongs where means you avoid duplicate contacts, failed records, or inconsistent attribution.
Tracking Submissions in Reports
Your Form GUID isn’t just for developers. If you build reports based on submission data, pulling results by GUID ensures your analytics don’t overlap or miss entries.
Example:
Maybe you launched A/B landing pages, each with its own HubSpot form, even though both look identical. Each form has its own GUID. When building your reports, use the GUID to differentiate submissions and track which version performs better. Otherwise, you could end up combining data from two different forms without realizing it.
Common Setup Errors and Wrong Assumptions
If you’re not using the correct GUID or confusing it with another ID, your forms may appear fine to users but silently fail behind the scenes.
Here are the top mistakes to avoid:
Assuming the Form ID and GUID Are the Same
They aren’t. The form ID might refer to a simplified or internal label. The GUID is a 36-character string your API and embed scripts depend on. Using the wrong one breaks integrations.
Copying a GUID From the Wrong Portal
Every HubSpot portal has its own GUIDs. If you’re testing in a sandbox and accidentally use that GUID in production, submissions won’t route correctly. Always confirm the GUID belongs to your live environment.
Expecting GUIDs to Update After Edits
The GUID is assigned once, and it doesn’t change. Even if you overhaul the form’s layout or rename it, the original GUID sticks. Replacing the form entirely is the only way to get a new GUID.
Copying Only Part of the GUID
One missing character is all it takes for a form to fail. Avoid copy-paste errors by grabbing the full string from the embed code between the quotation marks.
Step-by-Step Setup or Use Guide
Before diving in, make sure you have access to the relevant HubSpot account and form permissions. If you’re using the HubSpot API, you’ll also need an API key or private app token, depending on your setup.
Here’s how to retrieve your form’s GUID:
Step 1: Go to the Forms Tool
From your HubSpot dashboard, go to Marketing > Lead Capture > Forms.
Step 2: Select the Form
Choose the form you need. Clicking its name will open the form editor.
Step 3: Find the Share or Embed Option
In the editor toolbar, select the “Share” or “Embed” button. Location varies slightly by version.
Step 4: Copy the Embed Code
This code includes your form’s GUID and Portal ID. Copy it to a text editor so you can review or pass it to your dev team.
Step 5: Identify the GUID
Look inside the embed script for a line that reads something like:
formId: “a1b2c3d4-e5f6-7890-1234-abcdef567890”
That’s your GUID. Be sure to grab the full string.
Step 6: Copy It Accurately
Double-check that no characters are missing. Paste the value into your integration code, script, or documentation.
Step 7: Verify via the API (Optional)
If you prefer, call the endpoint at:
https://api.hubapi.com/forms/v2/forms
This retrieves a full list of GUIDs and related metadata.
Step 8: Test Your Integration
Submit a test entry, then check that the contact appears in HubSpot under the correct form. This confirms both your script and GUID are working as expected.
Document these values clearly, especially if multiple team members or vendors will touch your integration.
Measuring Results in HubSpot
Once your form is live and tied to the right GUID, tracking its performance is key. HubSpot offers several built-in tools that reference GUID-tagged data so you can evaluate and optimize over time.
The most effective tools you should use:
- Forms performance dashboard
See how many views and submissions each form receives. Use this to check that external forms are loading and logging data correctly. - Traffic analytics
Track how visitors find your form. Drill down into the source or medium by selecting the correct form from the dropdown filters. - Contact reports
Analyze contacts who entered through a specific form. Using the GUID ensures you don’t mix up forms with similar names. - Workflow tracking
Check how many form submissions triggered automations. If workflows don’t fire, you may be referencing the wrong GUID.
Use this mini-checklist to stay on track:
- Review submission trends weekly
- Compare views to submissions to gauge conversion
- Track new contact creation versus total submissions
- Test all workflows tied to that form
- Confirm forms embedded on external pages are logging data properly
Ongoing monitoring helps you catch problems before they affect leads or reporting accuracy.
Short Example That Ties It Together
Picture this.
Your product marketing team launches a free-trial page on Webflow. You build the signup form inside HubSpot. After clicking “Embed,” you get the script, copy the form GUID, and hand it off to your developer.
The developer pastes it into the live page’s code. Now, every time someone signs up, their info syncs directly into HubSpot. A workflow attached to that specific GUID triggers a welcome email and opens a deal in Sales.
Later, your RevOps team pulls a report and sees a 120% jump in trial signups, accurately tracked to that form via its GUID. Without that GUID, you wouldn’t see the data, and key workflows could fail silently. That one identifier holds the entire pipeline together.
How INSIDEA Helps
When you’re managing complex integrations or juggling multiple forms across different CMS platforms, getting form GUIDs right is non-negotiable. Mistakes here don’t always show up immediately, but they will affect attribution, lead routing, and workflow triggers down the line.
That’s where INSIDEA steps in.
Our team works with growth-focused companies to configure, audit, and optimize HubSpot forms at a technical level. Whether you’re building a brand-new site or cleaning up existing processes, we help you:
- Set up reliable form workflows from day one
- Ensure every GUID is tracked and documented clearly
- Build clean, compliant backend automation tied to form submissions
- Align your reports to reflect real performance metrics
Explore our services:
- HubSpot Onboarding
- HubSpot Portal and Workflow Management
- Advanced Automation Across Teams
- Custom Dashboards and CRM Integrations
If you’re ready to streamline your systems and prevent future data issues, talk to an INSIDEA expert today. Visit us at INSIDEA for technical help that keeps everything synced and flying in formation.
Finding your HubSpot Form GUID is just the start. Use it well, document it properly, and you’ll save hours of troubleshooting while keeping your lead capture rock solid.
Get in touch with our HubSpot experts today!
