Create contact list

Create an empty contact list in Findymail.

POST https://cotlet.dev/api/v1/findymail/contact-lists

write

Returns the new list with its ID and dates. It changes only your own account and reaches nobody, so it does not wait for your OK.

Parameters

Parameters: create_contact_list
NameTypeDescription
name string required string Name of the new list.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/findymail/contact-lists \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Doe"}'
Python
result = client.call("findymail", "create_contact_list", {"name":"Jane Doe"})
Node.js
const result = await cotlet.call('findymail', 'create_contact_list', {"name":"Jane Doe"});
CLI
cotlet call findymail create_contact_list --data '{"name":"Jane Doe"}'

Example response

JSON

{
  "list": {
    "id": 3140,
    "name": "Q1 outreach",
    "created_at": "2026-10-23T09:00:00Z",
    "updated_at": "2026-10-23T09:00:00Z",
    "shared_with_team": false,
    "is_owner": true
  }
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.