> ## Documentation Index > Fetch the complete documentation index at: https://iqma-31aad55c.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create > This endpoint is used to create a list. ## OpenAPI ````yaml api-reference/TMDB.json post /3/list openapi: 3.0.3 info: title: The Movie Database description: "# About\n\nThe Movie Database (TMDB) is a _community built_ movie and TV database. Every piece of data has been added by our amazing community dating back to 2008. TMDB's strong _international focus_ and breadth of data is largely unmatched and something we're incredibly proud of\n\nAlong with extensive metadata for movies, TV shows and people, we also offer one of the best selections of high resolution posters and backdrops. On average, over 1,000 images are added every single day.\n\n# Getting Started\n\nWelcome to version 3 (v3) of Ihe Movie Database(TMDB)API. This documentation serves as a guide to kick- start your experience with the world's largest movie database,\_Operating under the REST architecture. this API has become familiar to developers over the years, owing to its resemblance to the well-known web request and response pattern and its utillization of JSON as the preferred syntax for delivering responses.\n\nHere, you'll find information on all your favorite movies, including ratings, release dates, and much more. However, before you begin, be sure to explore the introductory pages, which include the Authentication page and the Errors & status code page.\_\n\n# Authentication \n\nBefore you can use the TMBD API, you need to generate your API Key - which is how you authenticate with the API.\nTo get an API key, you need to sign up at the officlal TMDB homepage. To do sign up, follow the steps below\_\n\n1. Navigate to the TMBD sign up page.\n\n2. After submitting your requested details, verify your account to login.\n3. Once you are logged in, you can now access your profile page containing information such as your most watched genres, and other recent activities.\n4. At the right corner of your profile page, navigate to your profile avatar and select the Settings options.\n5. On the settings page, navigate to the API option at the left corner menu.\n6. From the following options, chose the plan that suits you, The options include Developer and Professional. Both plans have their advantages listed below them.\n7.\_Once you select a plan, you'll fill out the form which would collect information about the API usage. information requested would include name of applicaton, it's url, etc.\n8. Once completed, you would be redirected to a new page where you'll see your generated API Key, Or check the notification icon for an instant message delivering your API key with additional informatian on the next steps to take." version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - apikey: [] tags: - name: Getting Started - name: Account description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Authentication description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Certifications - name: Changes - name: Collections description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Companies - name: Configuration - name: Credits description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Discover - name: Find description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Genres - name: Keywords description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movie Lists description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Movies description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Networks description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: People Lists - name: People description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Reviews description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Search - name: Trending - name: TV Series Lists - name: TV Series description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: TV Seasons - name: TV Episodes - name: TV Episode Groups description: >- [A guide to getting required parameters. ](https://docs.google.com/document/d/1nfEEA8uv1vq5trPMhXfp7PPh97u77NUgMi_6NCslnLo/edit?usp=sharing) - name: Watch Provider paths: /3/list: post: tags: - Lists summary: Create description: This endpoint is used to create a list. operationId: create requestBody: content: application/json: schema: type: object properties: description: type: string example: '' language: type: string example: en name: type: string example: for docs examples: Create: value: description: '' language: en name: for docs responses: '201': description: OK 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: Tue, 17 Dec 2024 14:51:45 GMT Server: schema: type: string example: openresty Vary: schema: type: string example: Origin Via: schema: type: string example: >- 1.1 2f66aa06710fece8ed203ab0ea81eb56.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: 5STeUqHRqfojK8Cozr4l--54K6H_5KPchg5-RLhkP88bq41hjWcvuQ== 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/"5e0bf46f65b9f6211dc52e4559711621" vary: schema: type: string example: accept-encoding content: application/json: schema: type: object properties: list_id: type: number example: 8501540 status_code: type: number example: 1 status_message: type: string example: Success. success: type: boolean example: true examples: OK: value: list_id: 8501540 status_code: 1 status_message: Success. success: true components: securitySchemes: apikey: type: apiKey name: '{{key}}' in: query ````