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

# Delete a test lead

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

Removes a test lead created for the form (DELETE /{leadgen_id}), so a new one can be submitted: Meta keeps one test lead per form and refuses a second until the first is gone. The same test lead appears in Meta's Lead Ads Testing Tool. Meta only deletes test leads; a real lead is refused.

## Path parameters

- `formId` string, required

## Query parameters

- `accountId` string, required
- `leadId` string

## Response `200`

Test lead deleted.

- object
  - `status` string
  - `deleted` string[] — Ids of the test leads removed.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — The form has no test lead.

## 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-23** `dd3865482f9f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/lead-forms/:formId/test-leads/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/e0122970214f?raw)