Skip to main content

DELETE /api/v1/public/lead-lists/:id/delete-leads/

Delete (archive) prospects or companies from a lead list. For people lists, prospects are archived (not permanently deleted). For company lists, companies are removed from the list. Auth: X-API-Key

Path Parameters

  • id (integer, required): Lead list ID

Request Body (For People Lists)

Request Body (For Company Lists)

Response (People List)

Response (Company List)

Important Notes

  • People Lists: Prospects are archived (status changed to “ARCHIVED”) rather than permanently deleted. This preserves the data and allows you to restore them later if needed.
  • Company Lists: Companies are removed from the list entirely.
  • Only leads that belong to the specified list can be deleted.

Error Responses

400 Bad Request

404 Not Found

Example Usage