List contact lists

Contact lists of the account, by name, with their IDs.

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

read

Returns the lists shown on the Contacts page, 50 to a page; pass next_cursor back as cursor for the next page. query filters by name. list_id goes into the other list tools and into send_sms and create_sms_campaign. ClickSend allows up to 2,000 contact lists, and every contact belongs to exactly one list.

Parameters

Parameters: list_contact_lists
NameTypeDescription
query string string Part of the list name.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "lists": [
    {
      "list_id": 128734,
      "name": "Newsletter subscribers"
    },
    {
      "list_id": 128741,
      "name": "Webinar leads"
    }
  ],
  "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.