POST
/
3
/
account
/
{account_id}
/
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

This refers to a unique identifier assigned to a user account.

Example:

""

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
media_id
number

A unique identifier for the specific movie in question. The value 11 corresponds to a particular movie in the database.

Example:

11

media_type
string

A string that specifies the type of the media item

Example:

"movie"

watchlist
boolean

A boolean value indicating the user's intention regarding the movie. If true, it means the user wants to add the movie to their watchlist. If it were false, it would indicate the user wants to remove it from their watchlist.

Example:

true

Response

201 - application/json
add to watchlist
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