Sign in
Lead Gen

Delete a test lead

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.

delete/v1/ads/lead-forms/{formId}/test-leads

Path parameters

formIdstring required

Query parameters

accountIdstring required

The facebook or metaads account whose Page owns the form.

leadIdstring

The test lead id returned by createTestLead (or shown in the Testing Tool). Omitted = the test lead currently on the form.

Response

Test lead deleted.

statusstring
deletedstring[]

Ids of the test leads removed.

Changes

Changed in 2 of the 55 revisions of this API.5

  • 2c04683ce6944See the full diff
    • ○

      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

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • dd3865482f9f1See the full diff
    • ○

      endpoint added

      endpoint-added