List contact lists

Your contact lists with name and number of contacts.

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

read

Returns the lists on the Contacts > Lists page, one page per call. An account holds up to 1,000 lists. Use list_id in list_contacts, add_contacts_to_list, remove_contacts_from_list and send_email.

Parameters

Parameters: list_lists
NameTypeDescription
limit integer integer How many items to return per page.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/constant-contact/lists \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("constant-contact", "list_lists")
Node.js
const result = await cotlet.call('constant-contact', 'list_lists');
CLI
cotlet call constant-contact list_lists

Example response

JSON

{
  "lists": [
    {
      "list_id": "5a8d3f21-6b9c-4e07-8d14-2f7c9e0a1b36",
      "name": "Tenants",
      "contacts": 312
    },
    {
      "list_id": "9d2e4b7a-1c3f-4a58-b6e0-7f8a2c5d1e90",
      "name": "Re-engage Oct 2026",
      "contacts": 0
    }
  ],
  "next_cursor": null
}

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.