Create list

Create a custom list with a name, a description and a privacy setting.

POST https://cotlet.dev/api/v1/trakt/lists

write Confirm

Creates an empty personal list. Privacy is 'private' unless you set it, and 'friends', 'link' or 'public' make the list visible to other people. The call fails with an account-limit error when you are at your list limit. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: create_list
NameTypeDescription
name string required string Name of the list.
description string string Short description.
privacy string string 'private', 'link', 'friends' or 'public'. Default: 'private'.

Request

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

Example response

JSON

{
  "list_id": "cozy-autumn",
  "name": "Cozy autumn",
  "privacy": "private",
  "item_count": 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.