Lists API
Create lists, add/remove contacts, and manage list membership.
Methods
create(data)Create a list with name and optional description.
update(id, data)Update list name or description.
addContacts(id, contactIds)Add contacts to a list.
removeContacts(id, contactIds)Remove contacts from a list.
listContacts(id)List all contacts in a list.
delete(id)Delete a list.
Example
// Create a list
const list = await lystica.lists.create({
name: "Enterprise Leads Q1",
description: "Filtered leads for Q1 outreach",
});
// Update
await lystica.lists.update("lst_abc123", { name: "Enterprise Leads Q2" });
// Add/remove contacts
await lystica.lists.addContacts("lst_abc123", ["cnt_1", "cnt_2", "cnt_3"]);
await lystica.lists.removeContacts("lst_abc123", ["cnt_1"]);
// List contacts in a list
const { data: contacts } = await lystica.lists.listContacts("lst_abc123");
// Delete
await lystica.lists.delete("lst_abc123");