> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

---
id: e4b2d3df-0660-47d7-a49a-917d01a22896
---

# 2026-09-beta Forms API

> These endpoints are used to create and manage forms in your HubSpot account.

export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<Accordion title="Scope requirements">
  <ScopesList
    scopes={[
  'forms'
]}
  />
</Accordion>

Use a HubSpot form to collect lead information about your visitors and contacts. You can use the endpoints outlined here to set up new forms or get details of forms you've previously created. If you're looking to send form submission data, you can use the [Submit data to a form endpoint](/api-reference/legacy/marketing/forms/v3-legacy/submit-data-authenticated) instead.

## What's new in 2026-09-beta

This version introduces a new versioned URL scheme for the Forms API. The base path has changed from `/marketing/v3/forms` to `/marketing/forms/2026-09-beta`.

The available endpoints and their behavior are otherwise identical to the `v3` legacy version:

| Method   | Path                                     | Description              |
| -------- | ---------------------------------------- | ------------------------ |
| `GET`    | `/marketing/forms/2026-09-beta`          | Retrieve a list of forms |
| `POST`   | `/marketing/forms/2026-09-beta`          | Create a new form        |
| `GET`    | `/marketing/forms/2026-09-beta/{formId}` | Retrieve a form by ID    |
| `PUT`    | `/marketing/forms/2026-09-beta/{formId}` | Replace a form           |
| `DELETE` | `/marketing/forms/2026-09-beta/{formId}` | Archive a form           |
| `PATCH`  | `/marketing/forms/2026-09-beta/{formId}` | Partially update a form  |

## Form types

The form's type indicates its purpose and is set to `hubspot` by default. You can use the following values for your `formType`:

* `hubspot`: these forms offer a variety of field types and styling options and can be used embedded in either HubSpot pages or external pages. These forms can be created and edited using the endpoints described here. You can also create these forms within your HubSpot account, learn more about [creating HubSpot forms](https://knowledge.hubspot.com/forms/create-forms).
* `captured`: these forms correspond to HTML forms in external websites. If the non-HubSpot forms tool is enabled and there are submissions to the form on [a tracked page](https://knowledge.hubspot.com/reports/install-the-hubspot-tracking-code), the form is automatically created in HubSpot. Learn more about [using non-HubSpot forms](https://knowledge.hubspot.com/forms/use-non-hubspot-forms).
* `flow`: these are pop-up forms that can be used in either HubSpot pages or external pages. Learn more about [HubSpot's pop-up forms tool](https://knowledge.hubspot.com/forms/create-pop-up-forms).
* `blog_comment`: these forms are automatically created for HubSpot blog pages to collect comments on blog posts. Learn more about how to further [set up and moderate blog comments](https://knowledge.hubspot.com/blog/set-up-and-moderate-your-blog-comments).