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

# Archive a form definition

`DELETE /marketing/forms/2027-03-beta/{formId}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/forms/2027-03-beta/{formId}`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `forms`

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.

---

[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/1445d97180da?raw)