Delete a list
Soft-delete a contact or company list. This is the cleanup counterpart of create_a_list: use it to remove destination lists once they are no longer needed (e.g. test or temporary prospecting lists). Requires the type query param (CONTACTS or COMPANIES) to disambiguate contact list IDs from company list IDs, which are independent sequences and can collide numerically. Only removes the list itself; contacts/companies that were members of the list are not deleted. If a contact list has an active recurring schedule, deletion stops that schedule first; if the schedule cannot be stopped, the delete is aborted (500) and the list is left intact rather than leaving a schedule running against a deleted list.
Required scope:
LISTS_WRITERate limit: 30 requests per minute
Authorizations
Path Parameters
The list ID
Query Parameters
Type of the list to delete (CONTACTS or COMPANIES). Required because contact list IDs and company list IDs are independent sequences and can collide numerically.
CONTACTS, COMPANIES