# Nylas Lists API

**Canonical:** https://apis.io/apis/nylas/nylas-lists-api/  
**Provider:** Nylas — https://apis.io/providers/nylas/  
**Base URL:** https://api.us.nylas.com  
**Documentation:** https://developer.nylas.com/docs/reference/api/applications/

Nylas Lists API is one of 40 APIs that [Nylas](https://apis.io/providers/nylas/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, authentication docs, and rate-limit docs.

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.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| POST | `/v3/lists` | Create a list |
| GET | `/v3/lists` | List lists |
| GET | `/v3/lists/{list_id}` | Get a list |
| PUT | `/v3/lists/{list_id}` | Update a list |
| DELETE | `/v3/lists/{list_id}` | Delete a list |
| POST | `/v3/lists/{list_id}/items` | Add items to a list |
| GET | `/v3/lists/{list_id}/items` | List items in a list |
| DELETE | `/v3/lists/{list_id}/items` | Remove items from a list |

## Machine-readable artifacts (17)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nylas/refs/heads/main/openapi/nylas-lists-api-openapi.yml
- **APIReference** — https://developer.nylas.com/docs/reference/notifications/
- **Documentation** — https://developer.nylas.com/docs/v3/notifications/
- **Documentation** — https://developer.nylas.com/docs/
- **APIReference** — https://developer.nylas.com/docs/reference/api/
- **GettingStarted** — https://developer.nylas.com/docs/v3/getting-started/
- **Authentication** — https://developer.nylas.com/docs/v3/auth/
- **RateLimits** — https://developer.nylas.com/docs/dev-guide/platform/rate-limits/
- **ErrorCodes** — https://developer.nylas.com/docs/api/errors/
- **Pricing** — https://www.nylas.com/pricing/
- **Signup** — https://dashboard-v3.nylas.com/register
- **StatusPage** — https://status.nylas.com/
- **SDKs** — https://github.com/nylas/nylas-nodejs
- **SDKs** — https://github.com/nylas/nylas-python
- **SDKs** — https://github.com/nylas/nylas-ruby
- **SDKs** — https://github.com/nylas/nylas-java
- **APIReference** — https://developer.nylas.com/docs/reference/api/application-level-templates/

## Other Nylas APIs (12)

- [Nylas Contacts API](https://apis.io/apis/nylas/nylas-contacts-api/)
- [Nylas Drafts API](https://apis.io/apis/nylas/nylas-drafts-api/)
- [Nylas Events API](https://apis.io/apis/nylas/nylas-events-api/)
- [Nylas Messages API](https://apis.io/apis/nylas/nylas-messages-api/)
- [Nylas Threads API](https://apis.io/apis/nylas/nylas-threads-api/)
- [Nylas Notetaker API](https://apis.io/apis/nylas/nylas-notetaker-api/)
- [Nylas Amazon SNS Notifications API](https://apis.io/apis/nylas/nylas-amazon-sns-notifications-api/)
- [Nylas App migration API](https://apis.io/apis/nylas/nylas-app-migration-api/)
- [Nylas Application-level templates API](https://apis.io/apis/nylas/nylas-application-level-templates-api/)
- [Nylas Application-level workflows API](https://apis.io/apis/nylas/nylas-application-level-workflows-api/)
- [Nylas Applications API](https://apis.io/apis/nylas/nylas-applications-api/)
- [Nylas Attachments API](https://apis.io/apis/nylas/nylas-attachments-api/)

## Tags

List

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nylas/nylas-lists-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nylas/.