> ## 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 Session

> This endpoint is used to create a valid session ID once a user validates the request token.



## OpenAPI

````yaml api-reference/TMDB.json post /3/authentication/session/new
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/authentication/session/new:
    post:
      tags:
        - Authentication
      summary: Create Session
      description: >-
        This endpoint is used to create a valid session ID once a user validates
        the request token.
      operationId: createSession
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_token:
                  type: string
                  example: 6bc047b88f669d1fb86574f06381005d93d3517a
            examples:
              Create Session:
                value:
                  request_token: 6bc047b88f669d1fb86574f06381005d93d3517a
      responses:
        '200':
          description: OK
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: br
            Date:
              schema:
                type: string
                example: Sun, 15 Dec 2024 10:19:54 GMT
            Server:
              schema:
                type: string
                example: openresty
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 e84404231b384141b3b0f51e40964ef6.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: wU5yj4d_ny5bLxcw2Cv0juWUXlGgl92Y5If9Xq9wl_zbPYSVRWUrmA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: IAD55-P7
            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/"d21bb74d4a5065cbd15e94ae42665bc1"
            vary:
              schema:
                type: string
                example: accept-encoding
          content:
            application/json:
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    example: 3cd9375f53bcfb63de0368dd87a617d762f0537e
                  success:
                    type: boolean
                    example: true
              examples:
                OK:
                  value:
                    session_id: 3cd9375f53bcfb63de0368dd87a617d762f0537e
                    success: true
        '401':
          description: error
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Length:
              schema:
                type: string
                example: '84'
            Date:
              schema:
                type: string
                example: Sat, 14 Dec 2024 05:16:04 GMT
            Server:
              schema:
                type: string
                example: openresty
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 e685e9e08c2e4b105f4d86b35da50628.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: MfxTddPaUbp9_VW4lEY7dvvPBMMmr9rNTNLDytzSkk9ihxChobOthA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: IAD89-C3
            X-Cache:
              schema:
                type: string
                example: Error from cloudfront
            cache-control:
              schema:
                type: string
                example: public, max-age=0
            vary:
              schema:
                type: string
                example: accept-encoding
          content:
            application/json:
              schema:
                type: object
                properties:
                  failure:
                    type: boolean
                    example: true
                  status_code:
                    type: number
                    example: 17
                  status_message:
                    type: string
                    example: Session denied.
                  success:
                    type: boolean
                    example: false
              examples:
                error:
                  value:
                    failure: true
                    status_code: 17
                    status_message: Session denied.
                    success: false
      security:
        - {}
components:
  securitySchemes:
    apikey:
      type: apiKey
      name: '{{key}}'
      in: query

````