Delete a prospect list

Deletes one of your lists, exactly like deleting it in the app. Prospects that are in this list and in no other list are permanently deleted with it, together with their campaign history. Prospects that are also in another list are kept. If any prospect that would be deleted is still active in a campaign, nothing is deleted and the response names the campaigns to pause first.

Required scope: prospects:write.

contacts_deleted is how many prospects were deleted with the list — the ones that were in no other list. It can be 0.

Deleted prospects lose their campaign history, so if you add the same people again later, the "Recently contacted" setting on your campaigns will not know they were already emailed. To keep someone, add them to another list before deleting this one.

Deleting a list also unlinks it from any LinkedIn campaign it was attached to.

Calling it again for a list that is already gone returns 404.

To stop new verification runs from creating lists in the first place, pass create_list: false to POST /verification/batches.