---
title: "Archive a form definition"
method: DELETE
path: "/marketing/forms/2026-09-beta/{formId}"
tags: ["Basic"]
---

# Archive a form definition

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

Delete a specific form from your HubSpot account using its unique identifier. This operation will permanently remove the form and cannot be undone. Ensure that you have the necessary permissions before performing this action.

## Path parameters

- `formId` string, required

## Response `204`

No content

## Other responses

- `default` — An error occurred.

## 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-04** (2026-09-beta) `78d0073d1637` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubspot/apis/marketing-forms/changes/marketing/forms/2026-09-beta/:formId/delete.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-forms.md) · [All operations](https://skmtc.dev/hubspot/apis/marketing-forms/llms.txt) · [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-forms/revisions/1888fa5f4986?raw)