---
title: "Archive a lead form"
method: DELETE
path: "/v1/ads/lead-forms/{formId}"
tags: ["Lead Gen"]
---

# Archive a lead form

`DELETE /v1/ads/lead-forms/{formId}`

Neither platform hard-deletes a form; this archives it (Meta status=ARCHIVED; LinkedIn state=ARCHIVED via PARTIAL_UPDATE). Meta forms must belong to the Page the accountId manages.

## Path parameters

- `formId` string, required

## Query parameters

- `accountId` string, required

## Response `200`

Archived.

- object
  - `status` string
  - `formId` string
  - `archived` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — No lead form with that id on the Page this account manages.

## Changes

- **2026-09-25** `2c04683ce694` — 4 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/stage` to the response with the `400` status
  - added the optional property `details/unconfirmedWrite` to the response with the `400` status
- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status
- **2026-09-12** `06acc34a7017` — 1 info
  - added the non-success response with the status `404`

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/lead-forms/:formId/delete.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/b2325332041a?raw)