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
| Name | Type | Description |
|---|---|---|
| name string required | string | List name, unique in the account. |
| description string | string | Up to 255 characters. |
Request
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"}' result = client.call("constant-contact", "create_list", {"name":"Jane Doe"}) const result = await cotlet.call('constant-contact', 'create_list', {"name":"Jane Doe"}); cotlet call constant-contact create_list --data '{"name":"Jane Doe"}' Example response
{
"list_id": "9d2e4b7a-1c3f-4a58-b6e0-7f8a2c5d1e90",
"name": "Re-engage Oct 2026",
"contacts": 0
}