Summary

Add a new custom list.

URL

http://api.trakt.tv/lists/add/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Sign in to view your API key.

• JSON POST

  • username

    trakt username.

  • password

    SHA1 hash of trakt password.

  • name

    The list name. This must be unique.

  • description (optional)

    Optional but recommended description of what the list contains.

  • privacy

    Privacy level, set it to private, friends, or public.

  • show_numbers (optional)

    The list should show numbers for each item. This is useful for ranked lists. Set it to true or false.

  • allow_shouts (optional)

    The list allows discussion by users who have access. Set it to true or false.

Example JSON POST

{
	"username": "username",
	"password": "sha1hash",
	"name": "Top 10 of 2011",
	"description": "These movies and shows really defined 2011 for me.",
	"privacy": "public",
	"show_numbers": true,
	"allow_shouts":true
}

Example Response

{
	"status": "success",
	"message": "list added",
	"name": "Top 10 of 2011",
	"slug": "top-10-of-2011",
	"privacy": "public",
	"show_numbers": true,
	"allow_shouts": true
}