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

# Create

> This endpoint allows you to create a list.



## OpenAPI

````yaml api-reference/openapi.yaml post /3/list
openapi: 3.0.3
info:
  title: The Movie Database API
  description: >-
    Welcome to the third version of The Movie Database (TMDB) API. Our API
    provides you with vast access to a range of movies, TV shows, actor
    information, and images.


    With the TMDB API, you can easily integrate any of these functionalities in
    your application.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
  - url: Collection
security:
  - bearerAuth: []
tags:
  - name: Validate Key
  - name: Authentication
  - name: Guest Sessions
  - name: Configuration
  - name: Account
  - name: Search
  - name: Discover
  - name: Find
  - name: Keyword
  - name: Lists
  - name: V3 vs V4
    description: >-
      There is version 4 (v4) for our list API. It contains several advanced
      improvements that differentiate it from the version 3 (v3) list. Although
      v3 lists will continue to work, you can only access these features if you
      switch to v4 lists.


      Some of the new improvements you can access on v4 lists include:


      - You can Import "unlimited" items in a single request
          
      - You can use mixed-type (movie and TV) lists
          
      - You can use private lists
          
      - You can add and use comments per item
          
      - There are more sort options
          
      - They are faster
          

      Check the v4 [documentation
      ](https://developer.themoviedb.org/v4/docs/getting-started) for more
      information.  
  - name: Collections
  - name: Companies
  - name: Networks
  - name: Trending
  - name: Movies
  - name: Movie Lists
  - name: TV Series
  - name: TV Series Lists
  - name: TV Seasons
  - name: TV Providers
  - name: TV Episode Groups
  - name: Watch Providers
  - name: People
  - name: People List
  - name: Genre
  - name: Changes
  - name: Credits
  - name: Certifications
paths:
  /3/list:
    post:
      tags:
        - Lists
      summary: Create
      description: This endpoint allows you to create a list.
      operationId: create
      parameters:
        - name: session_id
          in: query
          schema:
            type: string
            example: a30ca4b889498c1eaeba29bf38bcd439b75f15f7
          description: >-
            This represents your session ID. Get it
            [here](https://starlight.mintlify.app/api-reference/sessionid)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                description:
                  type: string
                  example: Just an awesome list.
                  description: This represents your list description.
                language:
                  type: string
                  example: en
                  description: This represents the language.
                name:
                  type: string
                  example: This is my awesome test list.
                  description: This represents your list name.
            examples:
              Create:
                value:
                  description: Just an awesome list.
                  language: en
                  name: This is my awesome test list.
      responses:
        '201':
          description: Create
          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: Fri, 03 Jan 2025 20:42:24 GMT
            Server:
              schema:
                type: string
                example: openresty
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 c35f767218cbd1125d801b52fa785c8c.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: 2K3oVZTCtmVpHzjS-fzkcErTNBATzYotwMWyUpc4CirBOxYp9ZWvEQ==
            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/"1bdcd8ca15c9b37c07082dd38886c17e"
            vary:
              schema:
                type: string
                example: accept-encoding
          content:
            application/json:
              schema:
                type: object
                properties:
                  list_id:
                    type: number
                    example: 8504996
                  status_code:
                    type: number
                    example: 1
                  status_message:
                    type: string
                    example: Success.
                  success:
                    type: boolean
                    example: true
              examples:
                Create:
                  value:
                    list_id: 8504996
                    status_code: 1
                    status_message: Success.
                    success: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````