Create a list

POST /lists

A contact list groups recipients for use in campaigns. Create the list first, then upload contacts via parse-csv + import, or add them one at a time.

Body parameters

Field	Type	Required	Description
name	string	yes	Max 255 chars.
description	string	no

Example

cURL

curl -X POST https://mail.3ava.com/api/lists \
  -H "Authorization: Bearer am_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter subscribers",
    "description": "Opted in via website footer"
  }'

Response

{
  "id": "list_a1b2...",
  "name": "Newsletter subscribers",
  "description": "Opted in via website footer",
  "total_contacts": 0,
  "valid_count": 0,
  "verification_status": "not_started",
  "created_at": "2026-04-22T22:30:00Z"
}