Lists
Add items to a list
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, and each item value can be at most 500 characters. Values that exceed this length return a 400.
post/v3/lists/{list_id}/items
Request body
Example request
{
"items": [
"spam-domain.com",
"another-bad-domain.net"
]
}Response
OK
Example response
{
"request_id": "5fa64c92-e840-4357-86b9-2aa364d35b88",
"data": {
"id": "d1e2f3a4-5678-4abc-9def-0123456789ab",
"name": "Blocked domains",
"description": "Domains we've identified as sending unwanted mail.",
"type": "domain",
"items_count": 42,
"application_id": "ad410018-d306-43f9-8361-fa5d7b2172e0",
"organization_id": "org-abc123",
"created_at": 1742932766,
"updated_at": 1742932766
}
}Changes
No recorded changes to this endpoint across all 1 revision of this API.