> ## Documentation Index
> Fetch the complete documentation index at: https://sirjosh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add To Watchlist

> This endpoint Add a movie or TV show to your watchlist.



## OpenAPI

````yaml api-reference/openapi3.json post /3/account/{account_id}/watchlist
openapi: 3.0.3
info:
  title: The Movie Database
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: AUTHENTICATION
  - name: ACCOUNT
  - name: CERTIFICATIONS
  - name: CHANGES
  - name: COLLECTIONS
  - name: COMPANY
  - name: CONFIGURATION
  - name: CREDIT
  - name: DISCOVER
  - name: FIND
  - name: GENRES
  - name: GUEST SESSIONS
  - name: KEYWORDS
  - name: LISTS
  - name: MOVIE LISTS
  - name: MOVIES
  - name: NETWORKS
  - name: PEOPLE LIST
  - name: PEOPLE
  - name: REVIEWS
  - name: SEARCH
  - name: TRENDING
  - name: TV SERIES LIST
  - name: TV SERIES
  - name: TV SEASONS
  - name: TV EPISODES
  - name: TV EPISODE GROUP
  - name: WATCH PROVIDERS
paths:
  /3/account/{account_id}/watchlist:
    parameters:
      - $ref: '#/components/parameters/account_id'
      - $ref: '#/components/parameters/session_id'
    post:
      tags:
        - ACCOUNT
      summary: Add To Watchlist
      description: This endpoint Add a movie or TV show to your watchlist.
      operationId: addToWatchlist
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                media_id:
                  type: number
                  example: 11
                  description: >-
                    A unique identifier for the specific movie in question. The
                    value 11 corresponds to a particular movie in the database.
                media_type:
                  type: string
                  example: movie
                  description: A string that specifies the type of the media item
                watchlist:
                  type: boolean
                  example: true
                  description: >-
                    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.
            examples:
              Add To Watchlist:
                value:
                  media_id: 11
                  media_type: movie
                  watchlist: true
      responses:
        '201':
          description: add to watchlist
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Length:
              schema:
                type: string
                example: '60'
            Date:
              schema:
                type: string
                example: Mon, 16 Dec 2024 13:30:36 GMT
            Server:
              schema:
                type: string
                example: openresty
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 20579d8c7e6a7d159f211e9ee1d4003c.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: 33ri6yttSa1judMlKkS5xGcpC1UtXJx-aMTXuv_3cGr077CsdIKqvA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: IAD89-C3
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            cache-control:
              schema:
                type: string
                example: public, max-age=0
            etag:
              schema:
                type: string
                example: W/"4543905c5703940a323f39bb4fdcba82"
            vary:
              schema:
                type: string
                example: accept-encoding
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addFavourite'
              examples:
                add to watchlist:
                  value:
                    status_code: 1
                    status_message: Success.
                    success: true
components:
  parameters:
    account_id:
      name: account_id
      in: path
      required: true
      description: This refers to a unique identifier assigned to a user account.
      schema:
        type: integer
        example: ''
    session_id:
      name: session_id
      in: query
      description: >-
        A token that represents a logged-in user's session after they have
        authenticated with their TMDB account.
      schema:
        type: string
        example: ''
  schemas:
    addFavourite:
      type: object
      properties:
        status_code:
          type: number
          example: 1
          description: >-
            An integer value representing the status of the response. A value of
            1 is often used to denote a generic success response.
        status_message:
          type: string
          example: Success.
          description: A string providing a brief indication of the status of the request.
        success:
          type: boolean
          example: true
          description: A boolean value indicating whether the request was successful.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````