How to Find a Form GUID in Hubspot

When you work with integrations, custom code, or advanced analytics in Hubspot, you often need the unique identifier for a form, known as the form GUID. This guide walks you through every supported way to locate that ID so you can connect forms to external tools, APIs, or embedded scripts without confusion.

The steps below are based on HubSpot’s official documentation and cover the most common areas where a form GUID appears in your account.

What is a Hubspot form GUID?

A form GUID is a globally unique identifier that Hubspot assigns to each form you create. Instead of using a simple name, technical integrations rely on this ID to ensure the correct form is referenced.

You will typically need the GUID when:

Sending submissions to Hubspot via the Forms API
Embedding a form in a custom-coded website or app
Integrating Hubspot with third-party tools that map specific forms
Troubleshooting or updating existing form embeds

The GUID is a long alphanumeric string that looks similar to 123abc45-def6-7890-gh12-ijk345lmn678.

How to find a Hubspot form GUID in the forms tool

The easiest place to locate a form GUID is directly inside the forms tool. Follow these steps to copy it safely.

Step-by-step: locate the Hubspot form GUID

In your Hubspot account, navigate to Marketing > Forms.
Find the form you want to use and click its name to open the form editor.
In the upper-right corner of the editor, look for the Embed option and click it.
A panel appears with the form embed code. Inside this code snippet, look for the formId parameter. This value is your form GUID.
Copy the GUID carefully, making sure not to include surrounding quotation marks or other code.

Once copied, you can paste the GUID into your integration settings, custom scripts, or API requests.

Tips for safely copying the GUID

Use your cursor to highlight only the GUID, not extra spaces.
Double-check for missing characters before saving to a configuration file.
Store the GUID in a secure documentation system if multiple teams work with Hubspot forms.

Finding a Hubspot form GUID from the page embed

If a form is already embedded on a website or landing page, you can also retrieve the GUID directly from the page’s source code. This method is useful when you do not have quick access to the forms tool but can view the live page.

Use your browser to inspect the form embed

Open the page where the Hubspot form appears in your browser.
Right-click near the form and select View Page Source or Inspect, depending on your browser.
Use the browser search feature (often Ctrl + F or Cmd + F) and search for formId.
You will see a script or embed code block similar to the one in the forms tool. Locate the formId parameter inside that block.
Copy the value assigned to formId; this is the same Hubspot form GUID used by the system.

This technique works whether the form is embedded on a HubSpot-hosted page or an external site that uses the standard embed code.

Locate Hubspot form GUIDs via the API

For more technical implementations, you can use the Hubspot Forms API to list forms and automatically retrieve their GUIDs. This is especially helpful when you manage many forms across multiple environments.

General approach with the Forms API

Ensure you have an authenticated connection to the Hubspot API using a private app token or other supported authentication method.
Call the endpoint that lists forms (as documented in HubSpot’s developer docs).
Review the JSON response. Each form object contains an internal ID and a GUID value.
Store or map the GUIDs to their corresponding form names for easier management.

Using the API lets you keep a synchronized catalog of forms for integrations, internal tools, or reporting systems that depend on consistent IDs.

Common Hubspot use cases for form GUIDs

Once you have the form GUID, you can plug it into various technical workflows. Below are a few common use cases.

Connecting Hubspot forms to external tools

Custom integrations: Pass the GUID to middleware or integration platforms that route data to and from Hubspot.
Server-side submissions: Use the GUID when posting form data from backend services to the Forms API.
Testing environments: Maintain separate GUIDs for staging and production forms while reusing the same field structure.

Managing multiple Hubspot form versions

Identify which GUID belongs to older vs. newer form versions.
Audit embedded pages to confirm they reference the correct, most recent GUID.
Reduce errors when retiring or cloning forms by tracking each identifier in your documentation.

Best practices when working with Hubspot form GUIDs

Accurate handling of these identifiers helps maintain reliable integrations and clean data.

Document every GUID: Maintain a simple table listing form name, GUID, purpose, and primary page location.
Avoid editing embeds manually without backups: Before you change any Hubspot embed code that includes a form GUID, save the original snippet.
Coordinate with your dev team: Share GUID changes with developers whenever forms are replaced or renamed.
Use naming conventions: Clear form names make it easier to match records in the forms tool or API output.

Official Hubspot reference and further help

For the most detailed and up-to-date instructions from the platform provider, review the official knowledge base article on finding form GUIDs here: How to find your form GUID in HubSpot.

If you need strategic help implementing complex tracking or integrations around Hubspot forms, you can also consult a specialist agency such as Consultevo, which focuses on CRM and marketing automation ecosystems.

Recap: working confidently with Hubspot form GUIDs

To summarize, you can reliably locate a form GUID in three main places:

Inside the Hubspot forms tool via the embed panel.
Directly in the HTML or script embed on any page where the form is published.
Through the Hubspot Forms API when you want to manage IDs programmatically.

By consistently using the correct GUID, you ensure that integrations, analytics, and custom code all point to the exact form you intend, supporting more accurate data collection and smoother marketing operations.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`