# Lists

Source: https://developer.nylas.com/docs/reference/api/lists/

The Lists endpoints let you manage typed collections of values (email addresses, domains, or top-level domains) that can be referenced by Rules using the `in_list` condition operator. Lists provide a way to maintain dynamic allow lists and block lists that are evaluated during inbound rule processing and outbound send evaluation without needing to update individual rules.

Each list has a `type` that determines what kind of values it accepts and which rule condition fields it can be matched against:

- **`domain`** — Domain names (for example, `example.com`). Matched against the `from.domain` or `recipient.domain` rule condition.
- **`tld`** — Top-level domains (for example, `com`, `xyz`). Matched against the `from.tld` or `recipient.tld` rule condition.
- **`address`** — Full email addresses (for example, `user@example.com`). Matched against the `from.address` or `recipient.address` rule condition.

List `type` is set at creation time and cannot be changed. Items within a list are managed via the `/v3/lists/{list_id}/items` sub-resource endpoints. Values are automatically normalized (lowercased and trimmed) and validated against the list's `type`. Duplicate additions are silently ignored. You can submit up to 1000 items per add or remove request, and each item value can be at most 500 characters.


## Endpoints

- **GET** `/v3/lists` - [List lists](https://developer.nylas.com/docs/reference/api/lists/list-lists/)
- **POST** `/v3/lists` - [Create a list](https://developer.nylas.com/docs/reference/api/lists/create-list/)
- **GET** `/v3/lists/{list_id}` - [Get a list](https://developer.nylas.com/docs/reference/api/lists/get-list/)
- **PUT** `/v3/lists/{list_id}` - [Update a list](https://developer.nylas.com/docs/reference/api/lists/update-list/)
- **DELETE** `/v3/lists/{list_id}` - [Delete a list](https://developer.nylas.com/docs/reference/api/lists/delete-list/)
- **GET** `/v3/lists/{list_id}/items` - [List items in a list](https://developer.nylas.com/docs/reference/api/lists/list-list-items/)
- **POST** `/v3/lists/{list_id}/items` - [Add items to a list](https://developer.nylas.com/docs/reference/api/lists/add-list-items/)
- **DELETE** `/v3/lists/{list_id}/items` - [Remove items from a list](https://developer.nylas.com/docs/reference/api/lists/remove-list-items/)