Create list

Create an empty contact list with a unique name.

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

write

Creates a list that no email goes to until you schedule one to it, and returns its list_id. The name must differ from every other list; a repeated name fails. It reaches no one and a list you do not need is simply left empty, so it does not wait for your OK.

Parameters

Parameters: create_list
NameTypeDescription
name string required string List name, unique in the account.
description string string Up to 255 characters.

Request

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

Example response

JSON

{
  "list_id": "9d2e4b7a-1c3f-4a58-b6e0-7f8a2c5d1e90",
  "name": "Re-engage Oct 2026",
  "contacts": 0
}

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.