Skip to content
Skip to main content
POST
/v3/lists/{list_id}/items

Add items to a listBeta

Adds items to the specified list. Values are normalized (lowercased and trimmed) and validated against the list's type — domain lists accept domain names, tld lists accept top-level domains, and address lists accept full email addresses. Duplicate additions are silently ignored.

The response returns the updated List object with a refreshed items_count. You can submit up to 1000 items per request.

NYLAS API KEY

Parameters

Path parameters

list_id*string

The ID of the list whose items you want to manage.

Request body

items*array<string>
Example: ["spam-domain.com","another-bad-domain.net"]
maxItems: 1000

Responses

request_idstring

ID of the request.

Example: "5fa64c92-e840-4357-86b9-2aa364d35b88"
dataobject
POSThttps://api.us.nylas.com/v3/lists/{list_id}/items

Find your API key in the Nylas Dashboard under API Keys in your application settings.

list_idrequiredstring

The ID of the list whose items you want to manage.

Loading editor...

Autocomplete and validation come from this endpoint's request schema.