Basic

Update a form definition

Update an existing form in your HubSpot account using the specified form ID. This endpoint allows you to modify the properties of a form, such as its configuration, display options, and legal consent options. Ensure that the form ID is valid and that you have the necessary permissions to update forms.

put/marketing/forms/2026-09-beta/{formId}

Path parameters

formIdstring required

Request body

archivedboolean required

archivedAtstring date-time

createdAtstring date-time required

formType'hubspot' required

idstring required

namestring required

updatedAtstring date-time required

Response

successful operation

archivedboolean required

archivedAtstring date-time

createdAtstring date-time required

formType'hubspot' required

idstring required

namestring required

updatedAtstring date-time required

Changes

Changed in 6 of the 55 revisions of this API.12138

Aug 17, 20262026-09-beta12cd90f1eb181See the full diff
- ○
  endpoint added
  endpoint-added
Jul 13, 20262026-09-beta0a2f094f9ab41See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
May 22, 20262026-09-beta36245144443e2See the full diff
- ○
  the security scope forms was added to the endpoint's security scheme oauth2
  api-security-scope-added
- ○
  the security scope forms-write was removed from the endpoint's security scheme oauth2
  api-security-scope-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 14, 20262026-09-betab74d391e3e83911See the full diff
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ○
  the request property with a default value became required
  request-property-became-required-with-default
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property //// became required for the status
  response-property-became-required
May 13, 20262026-09-betadb0d2eb4691d2123See the full diff
- ▲
  the request's body type changed from no type to object
  request-body-type-changed
- ▲
  the /// response's property type changed from no type to object for status
  response-property-type-changed
- ●
  removed subschema #2 from the request body allOf list
  request-body-all-of-removed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  removed subschema #2 from the /// response property allOf list for the response status
  response-property-all-of-removed
May 4, 20262026-09-beta78d0073d16371See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog