---
title: "Create MFA ticket"
method: PUT
path: "/auth/mfa/ticket"
tags: ["MFA"]
---

# Create MFA ticket

`PUT /auth/mfa/ticket`

Create a new MFA ticket or validate an existing one.

## Request body

- union — MFA response
  - object
    - `password` string, required
  - object
    - `recovery_code` string, required
  - object
    - `totp_code` string, required

## Response `200`

- MFATicket
  - `_id` string, required — Unique Id
  - `account_id` string, required — Account Id
  - `token` string, required — Unique Token
  - `validated` boolean, required — Whether this ticket has been validated (can be used for account actions)
  - `authorised` boolean, required — Whether this ticket is authorised (can be used to log a user in)
  - `last_totp_code` string, nullable — TOTP code at time of ticket creation

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/revolt/apis/revolt-api.md) · [All operations](https://skmtc.net/revolt/apis/revolt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revolt/revolt-api/revisions/fee80de86d4d/schema)