# Announcing Forms API v3 Developer Preview is Now Available

**URL:** <https://community.hubspot.com/t/announcing-forms-api-v3-developer-preview-is-now-available/34468>\
**Category:** Developer Announcements\
**Tags:** api, announcement\
**Created:** [March 24, 2021, 4:49pm UTC](https://community.hubspot.com/t/announcing-forms-api-v3-developer-preview-is-now-available/34468 "2021-03-24T16:49:04Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![rhenry](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/rhenry/32/13838_2.png) [@rhenry](https://community.hubspot.com/u/rhenry)\
**Post date:** [March 24, 2021, 4:49pm UTC](https://community.hubspot.com/t/announcing-forms-api-v3-developer-preview-is-now-available/34468/1 "2021-03-24T16:49:04Z")

</div>

# What’s happening?

# 

Forms API v3 Developer Preview is Now Available

We are continuing to build the next generation of HubSpot’s APIs to provide the consistency and completeness our developer community needs. Today, we are excited to announce that a refreshed [Forms API and documentation](https://developers.hubspot.com/docs/api/marketing/forms) is now available in developer preview.

# Here’s what’s new:

HubSpot uses forms to collect lead information. The v3 Forms API follows [HubSpot’s new API design standards](https://developers.hubspot.com/blog/building-the-next-generation-of-hubspots-apis) and can be used to create new forms or get information from existing ones.

It includes the following endpoints:

- Get a list of forms
- Create a form
- Get a form definition
- Update a form definition
- Partially update a form definition
- Archive a form definition

Also new is the concept of _formType_. When creating a new form, you’ll need to include one of the following form types: _hubspot (default), captured, flow or blog\_comment._

- **hubspot forms** offer a variety of field types and styling options and can be used embedded in a website page. Those [forms](https://knowledge.hubspot.com/forms/create-forms) can be created and edited using the endpoints described [here](https://developers.hubspot.com/docs/api/marketing/forms).
- **captured forms** correspond to [HTML forms](https://knowledge.hubspot.com/forms/use-non-hubspot-forms) in external websites and are created as a result of submissions.
- **flow forms** are used for[pop-ups.](https://knowledge.hubspot.com/pop-up-forms/create-pop-up-forms)
- **blog\_comment** forms are automatically created for HubSpot[blog pages](https://knowledge.hubspot.com/cos-blog/configure-your-blogs-comment-options).

Some other noteworthy highlights:

Two endpoints from the [v2 Forms API](https://legacydocs.hubspot.com/docs/methods/forms/forms_overview) are redundant and have not been rebuilt as part of the latest v3 Forms API, specifically [Get all fields from a form](https://legacydocs.hubspot.com/docs/methods/forms/v2/get_fields) and [Get a single field from a form](https://legacydocs.hubspot.com/docs/methods/forms/v2/get_field). Both these can be achieved with the v3 endpoint [Get a form definition.](https://developers.hubspot.com/docs/api/marketing/forms)

Additionally, the [Get submissions for a form](https://legacydocs.hubspot.com/docs/methods/forms/get-submissions-for-a-form)endpoint and [Submit data to a form](https://legacydocs.hubspot.com/docs/methods/forms/submit_form) endpoints are not part of this initial v3 release, but they will be addressed in a future update.

What this means for developers:

- Start testing out this new API. Developer preview is the perfect time to let us know what you think. We’ll be collecting and iterating quickly on your feedback, which could mean breaking changes. We don’t recommend using these endpoints in a production environment yet, but we’ll let you know when they’re ready to move out of developer preview and into general availability.
- Continue using the existing and stable [Forms API](https://legacydocs.hubspot.com/docs/methods/forms/forms_overview) in production. It will remain available and supported as we build out our platform with improved consistency and capability.

Please let us know if you have any feedback questions or by replying below.
