post
https://api.trakt.tv/users//lists
🔥 VIP Enhanced 🔒 OAuth Required
Create a new personal list. The name is the only required field, but the other info is recommended to ask for.
Limits
If the user's list limit is exceeded, a 420 HTTP error code is returned. Use the /users/settings method to get all limits for a user account. In most cases, upgrading to Trakt VIP will increase the limits.
Privacy
Lists will be private by default. Here is what each value means.
| Value | Privacy impact... |
|---|---|
private | Only you can see the list. |
link | Anyone with the share_link can see the list. |
friends | Only your friends can see the list. |
public | Anyone can see the list. |
JSON POST Data
| Key | Type | Default | Value |
|---|---|---|---|
name * | string | Name of the list. | |
description | string | Description for this list. | |
privacy | string | private | private, link, friends, public |
display_numbers | boolean | false | Should each item be numbered? |
allow_comments | boolean | true | Are comments allowed? |
sort_by | string | rank | rank, added, title, released, runtime, popularity, random, percentage, imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes, imdb_votes, tmdb_votes, my_rating, watched, collected |
sort_how | string | asc | asc, desc |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…