---
title: "Changes to Update a form definition"
method: PUT
path: "/marketing/forms/2026-09-beta/{formId}"
---

# Changes to Update a form definition

`PUT /marketing/forms/2026-09-beta/{formId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 55 revisions.

- **2026-08-17** (2026-09-beta) `12cd90f1eb18` — 1 info
- **2026-07-13** (2026-09-beta) `0a2f094f9ab4` — 1 breaking
- **2026-05-22** (2026-09-beta) `36245144443e` — 2 info
- **2026-05-14** (2026-09-beta) `b74d391e3e83` — 9 breaking, 11 info
- **2026-05-13** (2026-09-beta) `db0d2eb4691d` — 2 breaking, 1 warning, 23 info
- **2026-05-04** (2026-09-beta) `78d0073d1637` — 1 info

## Changes

- **2026-08-17** (2026-09-beta) `12cd90f1eb18` — 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `0a2f094f9ab4` — 1 breaking
  - api path removed without deprecation
- **2026-05-22** (2026-09-beta) `36245144443e` — 2 info
  - the security scope `forms` was added to the endpoint's security scheme `oauth2`
  - the security scope `forms-write` was removed from the endpoint's security scheme `oauth2`
- **2026-05-14** (2026-09-beta) `b74d391e3e83` — 9 breaking, 11 info
  - the request property `archived` became required
  - the request property `configuration` became required
  - the request property `createdAt` became required
  - the request property `displayOptions` became required
  - the request property `fieldGroups` became required
  - the request property `id` became required
  - the request property `legalConsentOptions` became required
  - the request property `name` became required
  - the request property `updatedAt` became required
  - the request property `formType` with a default value became required
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/archived` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/configuration` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/createdAt` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/displayOptions` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/fieldGroups` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/formType` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/legalConsentOptions` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/HubSpotFormDefinition]/updatedAt` became required for the status `200`
- **2026-05-13** (2026-09-beta) `db0d2eb4691d` — 2 breaking, 1 warning, 23 info
  - the request's body type changed from no type to `object`
  - the `oneOf[#/components/schemas/HubSpotFormDefinition]/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/FormDefinitionBase, subschema #2` from the request body `allOf` list
  - added the new optional request property `archived`
  - added the new optional request property `archivedAt`
  - added the new optional request property `configuration`
  - added the new optional request property `createdAt`
  - added the new optional request property `displayOptions`
  - added the new optional request property `fieldGroups`
  - added the new optional request property `formType`
  - added the new optional request property `id`
  - added the new optional request property `legalConsentOptions`
  - added the new optional request property `name`
  - added the new optional request property `updatedAt`
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/archived` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/archivedAt` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/configuration` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/createdAt` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/displayOptions` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/fieldGroups` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/formType` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/id` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/legalConsentOptions` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/name` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/HubSpotFormDefinition]/updatedAt` to the response with the `200` status
  - removed `#/components/schemas/FormDefinitionBase, subschema #2` from the `oneOf[#/components/schemas/HubSpotFormDefinition]/` response property `allOf` list for the response status `200`
- **2026-05-04** (2026-09-beta) `78d0073d1637` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hubspot/apis/marketing-forms/docs/marketing/forms/2026-09-beta/:formId/put.md) · [API](https://skmtc.dev/hubspot/apis/marketing-forms.md) · [Page](https://skmtc.dev/hubspot/apis/marketing-forms/changes/marketing/forms/2026-09-beta/:formId/put)