Skip to main content
POST
/
3
/
list
Create
curl --request POST \
  --url https://api.themoviedb.org/3/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Just an awesome list.",
  "language": "en",
  "name": "This is my awesome test list."
}'
{
  "list_id": 8504996,
  "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

This represents your session ID. Get it here

Example:

"a30ca4b889498c1eaeba29bf38bcd439b75f15f7"

Body

application/json
​
description
string

This represents your list description.

Example:

"Just an awesome list."

​
language
string

This represents the language.

Example:

"en"

​
name
string

This represents your list name.

Example:

"This is my awesome test list."

Response

201 - application/json

Create

​
list_id
number
Example:

8504996

​
status_code
number
Example:

1

​
status_message
string
Example:

"Success."

​
success
boolean
Example:

true