PedibeeDocs

Lists

Named, hand-picked groups of contacts.

A list is a named group of contacts, e.g. Q4 prospects or Webinar sign-ups. Campaigns and sequences can send to a list. A person can be in any number of lists, and deleting a list never deletes its people.

The list object

{
  "id": "66f1c2a9e4b0a1b2c3d4e101",
  "name": "Q4 prospects",
  "description": "Warm intros from the conference",
  "contactCount": 2,
  "createdAt": "2026-10-05T09:30:00.000Z",
  "updatedAt": "2026-10-05T09:30:00.000Z"
}

Prop

Type

To see who's in a list, list contacts with listId.

Endpoints

GET/listsList listsPOST/listsCreate a listGET/lists/:idGet a listPATCH/lists/:idUpdate a listDELETE/lists/:idDelete a listPOST/lists/:id/contactsAdd people to a listDELETE/lists/:id/contactsRemove people from a list

Delete a custom field

Delete a field and clear its value from every contact.

List lists

All your contact lists, most recently changed first.

On this page

The list objectEndpoints