Add a contact

POST /lists/{id}/contacts

Add a single contact to a list. Email verification is queued automatically; the contact starts with verification_status: "unknown" and updates within seconds.

Body parameters

Field	Type	Required	Description
email	string	yes	Primary email.
emails	string[]	no	Additional emails (up to 9).
first_name	string	no
last_name	string	no
phone	string	no	Normalized to E.164.
phones	string[]	no	Additional phone numbers.
company	string	no
custom_fields	object	no	Free-form key/value ({"state": "CA"}).

Example

cURL

curl -X POST https://mail.3ava.com/api/lists/list_a1b2.../contacts \
  -H "Authorization: Bearer am_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "first_name": "Maria",
    "last_name": "Santos",
    "custom_fields": {"state": "CA"}
  }'

Response

{
  "id": "ct_abc123",
  "email": "[email protected]",
  "first_name": "Maria",
  "last_name": "Santos",
  "verification_status": "unknown",
  "created_at": "2026-04-22T22:30:00Z"
}