Skip to main content
POST
/
3
/
account
/
{account_id}
/
watchlist
Add movie to watchlist
curl --request POST \
  --url https://api.themoviedb.org/3/account/{account_id}/watchlist \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "media_id": 11,
  "media_type": "movie",
  "watchlist": true
}'
{
  "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.

Path Parameters

​
account_id
integer
required

A unique numeric identifier for a user account on TMDB. See how to get account id here.

Example:

548

Query Parameters

​
session_id
string

A unique identifier for an authenticated user session. Usually used for user authentication

Example:

"02a0e6d34dbd8325254e83c78918599076a62b0e"

Body

application/json
​
media_id
number

The unique identifier for the media item.

Example:

11

​
media_type
string

The type of media, such as movie or tv.

Example:

"movie"

​
watchlist
boolean

Indicates whether the media item should be added to watchlist. Usually true.

Example:

true

Response

201 - application/json

Request successful

​
status_code
number

A numeric code indicating the status of the request

Example:

1

​
status_message
string

A brief message describing the status of the request

Example:

"Success."

​
success
boolean

The boolean value describing the state of the request. Possible values - true or false

Example:

true

⌘I