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

A boolean value that indicates whether the user is adding the movie to their favorites (true) or removing it from their favorites (false).

Example:

true

​
media_id
number

A unique identifier for the specific movie in question.

Example:

550

​
media_type
string

A string that indicates the type of media the request pertains to. In this case, "movie" specifies that the media is a movie.

Example:

"movie"

Response

201 - application/json

add favourite

​
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