# Lists

Organize contacts into lists. Every contact must belong to a list. Use lists to segment your audience for outreach campaigns.


## List all lists

 - [GET /leads/api/lists](https://api.grinfi.io/openapi/lists/listlists.md): Retrieve all contact lists in your account. Lists are used to organize contacts into groups for outreach campaigns.

## Create a list

 - [POST /leads/api/lists](https://api.grinfi.io/openapi/lists/createlist.md): Create a new contact list.

## Get a list

 - [GET /leads/api/lists/{uuid}](https://api.grinfi.io/openapi/lists/getlist.md): Retrieve details of a specific contact list.

## Update a list

 - [PUT /leads/api/lists/{uuid}](https://api.grinfi.io/openapi/lists/updatelist.md): Rename an existing contact list.

## Delete a list

 - [DELETE /leads/api/lists/{uuid}](https://api.grinfi.io/openapi/lists/deletelist.md): Permanently delete a contact list.

## Get list metrics

 - [POST /leads/api/lists/metrics](https://api.grinfi.io/openapi/lists/getlistmetrics.md): Get lead counts for specified lists.