---
reference:
  curl:
    - key: create_password_reset
      id: create_password_reset
      url: /reference/authkit/password-reset/create
      title: /user_management/password_reset
      type: POST
      sendsEmail: true
      parameters:
        - key: email
          type: string
          description: (password_reset.email)
      returns:
        - (password_reset)
  js:
    - key: createPasswordReset
      id: create_password_reset
      url: /reference/authkit/password-reset/create
      title: userManagement.createPasswordReset()
      sendsEmail: true
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: email
              type: string
              description: (password_reset.email)
      returns:
        - (PasswordReset)
  go:
    - key: CreatePasswordReset
      id: create_password_reset
      url: /reference/authkit/password-reset/create
      title: usermanagement.CreatePasswordReset()
      parameters:
        - (ctx)
        - key: opts
          type: usermanagement.CreatePasswordResetOpts
          unwrap: true
          properties:
            - key: Email
              type: string
              description: (password_reset.email)
      returns:
        - (PasswordReset)
        - (err)
  php:
    - key: createPasswordReset
      id: create_password_reset
      url: /reference/authkit/password-reset/create
      title: $userManagement->createPasswordReset()
      sendsEmail: true
      parameters:
        - key: email
          type: string
          description: (password_reset.email)
      returns:
        - (PasswordReset)
  python:
    - key: create_password_reset
      id: create_password_reset
      url: /reference/authkit/password-reset/create
      title: user_management.create_password_reset()
      sendsEmail: true
      parameters:
        - key: email
          type: str
          description: (password_reset.email)
      returns:
        - (PasswordReset)
  ruby:
    - key: create_password_reset
      id: create_password_reset
      url: /reference/authkit/password-reset/create
      title: UserManagement.create_password_reset()
      sendsEmail: true
      parameters:
        - key: email
          type: String
          description: (password_reset.email)
      returns:
        - (PasswordReset)
  java:
    - key: createPasswordReset
      id: create_password_reset
      url: /reference/authkit/password_reset/create
      title: userManagement.createPasswordReset()
      sendsEmail: true
      parameters:
        - key: email
          type: String
          description: (password_reset.email)
      returns:
        - (PasswordReset)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/authkit/password-reset/create.mdx
---

## Create a password reset token

Creates a one-time token that can be used to reset a user's password.

<CodeBlock referenceId="create_password_reset">
  <CodeBlockTab title="Request" file="create-password-reset-request" />
  <CodeBlockTab title="Response" file="create-password-reset-response" />
</CodeBlock>