POST
/
3
/
list
Create List_id
curl --request POST \
  --url https://api.themoviedb.org/3/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "This contains the list of all anime, movie or TV shows",
  "language": "en",
  "name": "Anime"
}'
{
  "list_id": 8504995,
  "status_code": 1,
  "status_message": "Success.",
  "success": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
session_id
string

A token that represents a logged-in user's session after they have authenticated with their TMDB account.

Example:

""

Body

application/json
​
description
string

This describe our list. i.e what our list should contain.

Example:

"This contains the list of all anime, movie or TV shows"

​
language
string

Specifies the language we are using to create the list.

Example:

"en"

​
name
string

This is the name of the list.

Example:

"Anime"

Response

201 - application/json

create list_id

​
status_code
number

An integer value representing the status of the response. A value of 1 is often used to denote a generic success response.

Example:

1

​
status_message
string

A string providing a brief indication of the status of the request.

Example:

"Success."

​
success
boolean

A boolean value indicating whether the request was successful.

Example:

true

​
list_id
number

This is the unique identifier of the list been created

Example:

8504995