v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Lists
v1

Delete List

Delete a list from the account. Once removed, the list will no longer be accessible.

Credit Note: Deleting list does not consume credits.

:::info Requires the lists:write OAuth2 scope. :::

delete/v1/lists/{id}

Path parameters

idstring required

Unique identifier of the list (e.g. company_123)

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Response

Success

{"stackTrail":"paths:/v1/lists/{id}:delete:responses:200:content:application/json:schema:properties:data","oasType":"schema","type":"unknown"}

Example response

{
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}