Manage Lists
Create lists, add and update contacts, and change what is in a list after it has been built.
Everything else in these docs adds data to a list by sourcing or enriching it. These endpoints work on the list itself: create one, put your own contacts in it, correct them, and remove or move them.
Removing contacts from a list keeps the list itself. Deleting a whole list is done in the Parvenu app, not through the API.
Creating
Create a List makes an empty list by name. It is safe to repeat: a list that already exists is left as it is.
Adding
Add a Contact and Add Contacts in Bulk put contacts you already have (from a CRM, a form or a spreadsheet) into a list without enriching them. A contact the list already has is combined with it rather than duplicated, and a missing list is created for you.
Updating
Update a Contact and Update Contacts in Bulk change or clear fields on contacts already in a list. Every contact that matches is updated, so check with dry_run first.
Removing
Remove a Contact and Remove Contacts in Bulk delete rows. The data is gone, and re-adding those contacts means enriching them again.
Moving
Move a Contact and Move Contacts in Bulk send rows to a different list instead. The row itself is re-pointed, so every column and every log line comes along and nothing is re-enriched. If the destination already holds that contact, the two are merged rather than duplicated.
When the contacts belong somewhere else rather than nowhere, move them. Removing and re-sourcing costs credits for data you already have.
Saved views
List Saved Views shows the saved views (named sets of table filters saved in the app) you can use. Send one as saved_view on any _list enrichment to run it on just that view's contacts.
Every endpoint below is free and none costs credits. All of them answer immediately; there is no job to poll.