---
descriptions:
  create_passwordless_session:
    email: The email of the user to authenticate.
    type: >-
      The type of Passwordless Session to create. Currently, the only supported
      value is `MagicLink`.
    redirect_uri: >-
      Optional parameter that a developer can choose to include in their
      authorization URL. If included, it will override the default Redirect URI
      set in the dashboard. This is the location your user will be redirected to
      once the session has been completed successfully.
    expires_in: >
      The number of seconds the Passwordless Session should live before
      expiring.


      This value must be between `900` (15 minutes) and `86400` (24 hours),
      inclusive.
    state: >
      Optional parameter that a developer can choose to include in their
      authorization URL. If included, then the redirect URI received from WorkOS
      will contain the exact `state` that was passed in the authorization URL.


      The `state` parameter can be used to encode arbitrary information to help
      restore application state between redirects.
reference:
  curl:
    - key: create_passwordless_session
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: /passwordless/sessions
      type: POST
      parameters:
        - key: email
          type: string
          description: (create_passwordless_session.email)
        - key: type
          type: '"MagicLink"'
          description: (create_passwordless_session.type)
        - key: redirect_uri
          type: string
          optional: true
          description: (create_passwordless_session.redirect_uri)
        - key: expires_in
          type: number
          optional: true
          description: (create_passwordless_session.expires_in)
        - key: state
          type: string
          optional: true
          description: (create_passwordless_session.state)
      returns:
        - (passwordless_session)
  dotnet:
    - key: CreateSession
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: passwordlessService.CreateSession()
      parameters:
        - key: options
          type: CreatePasswordlessSessionOptions
          expanded: true
          properties:
            - key: Email
              type: string
              description: (create_passwordless_session.email)
            - key: Type
              type: PasswordlessSessionType
              description: (create_passwordless_session.type)
            - key: RedirectURI
              type: string
              optional: true
              description: (create_passwordless_session.redirect_uri)
            - key: ExpiresIn
              type: int
              optional: true
              description: (create_passwordless_session.expires_in)
            - key: State
              type: string
              optional: true
              description: (create_passwordless_session.state)
        - (cancellationToken)
      returns:
        - key: Task<PasswordlessSession>
          description: (passwordless_session.self)
  python:
    - key: create_session
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: passwordless.create_session()
      parameters:
        - key: email
          type: str
          description: (create_passwordless_session.email)
        - key: type
          type: '"MagicLink"'
          description: (create_passwordless_session.type)
        - key: redirect_uri
          type: str
          optional: true
          description: (create_passwordless_session.redirect_uri)
        - key: state
          type: str
          optional: true
          description: (create_passwordless_session.state)
      returns:
        - (PasswordlessSession)
  js:
    - key: createSession
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: passwordless.createSession()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: email
              type: string
              description: (create_passwordless_session.email)
            - key: type
              type: '"MagicLink"'
              description: (create_passwordless_session.type)
            - key: redirectURI
              type: string
              optional: true
              description: (create_passwordless_session.redirect_uri)
            - key: expiresIn
              type: number
              optional: true
              description: (create_passwordless_session.expires_in)
            - key: state
              type: string
              optional: true
              description: (create_passwordless_session.state)
      returns:
        - (PasswordlessSession)
  ruby:
    - key: create_session
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: Passwordless.create_session()
      parameters:
        - key: email
          type: String
          description: (create_passwordless_session.email)
        - key: type
          type: '"MagicLink"'
          description: (create_passwordless_session.type)
        - key: redirect_uri
          type: String
          optional: true
          description: (create_passwordless_session.redirect_uri)
        - key: expires_in
          type: Integer
          optional: true
          description: (create_passwordless_session.expires_in)
        - key: state
          type: String
          optional: true
          description: (create_passwordless_session.state)
      returns:
        - (PasswordlessSessionStruct)
  go:
    - key: CreateSession
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: passwordless.CreateSession()
      parameters:
        - (ctx)
        - key: opts
          type: passwordless.CreateSessionOpts
          expanded: true
          properties:
            - (PasswordlessSession.Email)
            - key: Type
              type: passwordless.PasswordlessSessionType
              description: (create_passwordless_session.type)
            - key: RedirectURI
              type: string
              optional: true
              description: (create_passwordless_session.redirect_uri)
            - key: ExpiresIn
              type: int
              optional: true
              description: (create_passwordless_session.expires_in)
            - key: State
              type: string
              optional: true
              description: (create_passwordless_session.state)
      returns:
        - key: session
          type: passwordless.PasswordlessSession
          description: (passwordless_session.self)
        - (err)
  php:
    - key: createSession
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: $passwordless->createSession()
      parameters:
        - key: email
          type: string
          description: (create_passwordless_session.email)
        - key: type
          type: '"MagicLink"'
          description: (create_passwordless_session.type)
        - key: redirectUri
          type: string
          optional: true
          description: (create_passwordless_session.redirect_uri)
        - key: expiresIn
          type: int
          optional: true
          description: (create_passwordless_session.expires_in)
        - key: state
          type: string
          optional: true
          description: (create_passwordless_session.state)
      returns:
        - (PasswordlessSession)
  java:
    - key: createSession
      id: create_passwordless_session
      url: /reference/magic-link/passwordless-session/create
      title: passwordless.createSession()
      parameters:
        - key: options
          type: CreateSessionOptions
          expanded: true
          properties:
            - key: email
              type: String
              description: (create_passwordless_session.email)
            - key: type
              type: SessionType
              description: (create_passwordless_session.type)
            - key: redirectUri
              type: String
              optional: true
              description: (create_passwordless_session.redirect_uri)
            - key: expiresIn
              type: Int
              optional: true
              description: (create_passwordless_session.expires_in)
            - key: state
              type: String
              optional: true
              description: (create_passwordless_session.state)
            - key: builder()
              type: CreateSessionOptionsBuilder
              description: (java.builder)
      returns:
        - (PasswordlessSession)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/magic-link/passwordless-session/create.mdx
---

## Create Passwordless Session [Deprecated]

Create a Passwordless Session for a Magic Link Connection.

<CodeBlock referenceId="create_passwordless_session">
  <CodeBlockTab title="Request" file="create-passwordless-session-request" />
  <CodeBlockTab title="Response" file="create-passwordless-session-response" />
</CodeBlock>