> ## Documentation Index > Fetch the complete documentation index at: https://emiloju.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create a list > This endpoint is used to create a list for a TMDB user. ## OpenAPI ````yaml api-reference/openapi.yaml post /3/list openapi: 3.0.3 info: title: Endpoints description: This section contains all the endpoints used in the documentation. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: Authentication description: This section contains all endpoints used for authentication - name: Accounts description: This section contains account-specific endpoints. - name: Favorites description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows, episodes to favorites, and also to get a list of favorites for the account. - name: Movies description: >- This section contains an endpoint to add a movie to favorites, and another to get a list of favorite movies for a TMDB account. - name: TV shows description: >- This section contains an endpoint to get the favorite TV shows for an account. - name: Watchlist description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows to watchlist, and also to get a list of watchlist for the account. - name: Movies1 description: >- This section contains an endpoint that allows a TMDB account to add a movie to watchlist, and another to get the movies in a watchlist. - name: TV shows1 description: >- This section contains an endpoint used to get TV shows in an account's watchlist. - name: Ratings description: >- This section contains endpoints used to get all movies, TV Shows, and episodes rated by a TMDB account. - name: Movies12 description: >- This section contains an endpoint used to get a list of movies rated by a TMDB account. - name: TV shows12 description: >- This section contains an endpoint used to get a list of TV shows rated by a TMDB account. - name: Episodes description: >- This section contains an endpoint used to get a list of episodes rated by a TMDB account. - name: Lists description: Endpoints for a TMDB account lists. - name: Guest sessions description: This section contains all endpoints accessible by a guest session. - name: Movies description: For movies. - name: TV episodes description: >- This section contains all endpoints used to retrieve data for all TV episodes. - name: TV seasons description: >- This section contains all endpoints used to retrieve data for all TV seasons. - name: TV series description: >- This section contains all endpoints used to retrieve data for all TV series. - name: TV series lists description: This section contains all endpoints used to list TV series. - name: TV episode groups description: This section contains an endpoint used to retrieve data for TV episodes. - name: Watch providers description: Get available regions. - name: People description: About people lists. - name: Companies description: >- This section contains all endpoints used to retrieve data for supported companies. - name: Discover description: This section contains all endpoints used to discover movies and TV shows. - name: Recent changes description: >- This section contains all endpoints used to get recent changes in the TMDB database. - name: Credit description: This section contains an endpoint used to retrieve movie credits. - name: Certifications description: >- This section contains all endpoints used to get certification for movies and TV shows. - name: Collections description: This section contains all endpoints used to retrieve data for collections - name: Configuration description: >- This section contains all endpoints used to retrieve data on TMDB's configurations. - name: Find description: >- This section contains an endpoint used to search the TMDB database by External ID. - name: Genres description: This section contains endpoints related to genres. - name: Keywords description: >- This section contains an endpoint used to get keywords in the database by an ID. - name: Movie lists description: >- This section contains all endpoints used to retrieve movies by multiple search filters. - name: Networks description: For network endpoints. - name: Reviews description: For reviews endpoints. - name: Search description: For search endpoints. - name: Trending description: For trending videos. paths: /3/list: post: tags: - Accounts - Lists summary: Create a list description: This endpoint is used to create a list for a TMDB user. operationId: createAList parameters: - $ref: '#/components/parameters/sessionID' requestBody: content: application/json: schema: type: object properties: description: type: string example: A list of movies for the holiday season description: A description for the list language: type: string example: en description: >- The language code of the list's content such as `en` as English name: type: string example: Christmas movie list. description: The title of the new list examples: Example request: value: description: A list of movies for the holiday season language: en name: Christmas movie list. responses: '201': description: Request successful headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Connection: schema: type: string example: keep-alive Content-Length: schema: type: string example: '78' Date: schema: type: string example: Wed, 01 Jan 2025 21:52:18 GMT Server: schema: type: string example: openresty Vary: schema: type: string example: Origin Via: schema: type: string example: >- 1.1 343bfbd831f62ab698056c2ca0efaabc.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: n0SESL6hM_iRuXJt8cqQ8GUXCmtFTabQaSlT1irc7d6D3Q1LKNzrag== X-Amz-Cf-Pop: schema: type: string example: CDG50-C1 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/"15058ede40ba8cc0fc57d0a6a1612aa3" vary: schema: type: string example: accept-encoding content: application/json: schema: type: object properties: list_id: type: number example: 8504581 description: A unique identifier for the new list status_code: type: number example: 1 description: A numeric code indicating the status of the request status_message: type: string example: Success. description: A brief message describing the status of the request success: type: boolean example: true description: >- A boolean value describing the state of the request. Possible value - `true` or `false` examples: Example response: value: list_id: 8504581 status_code: 1 status_message: Success. success: true components: parameters: sessionID: in: query name: session_id schema: type: string example: 02a0e6d34dbd8325254e83c78918599076a62b0e description: >- A unique identifier for an authenticated user session. Usually used for [user authentication]() securitySchemes: bearerAuth: type: http scheme: bearer ````