---
title: "POST /v1/users/me/mfa/setup — create or replace a pending MFA secret."
method: POST
path: "/v1/users/me/mfa/setup"
tags: ["users"]
---

# POST /v1/users/me/mfa/setup — create or replace a pending MFA secret.

`POST /v1/users/me/mfa/setup`

## Response `200`

MFA setup initialized

- MfaSetupResponse — Response from initiating MFA setup — contains the secret and provisioning URI.
  - `account_name` string, required
  - `issuer` string, required
  - `provisioning_uri` string, required
  - `secret` string, required

## Other responses

- `400` — Already enabled
- `401` — Unauthorized

---

[API](https://skmtc.dev/microsandbox/apis/microsandbox-api.md) · [All operations](https://skmtc.dev/microsandbox/apis/microsandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microsandbox/microsandbox-api/revisions/23f2a45cb09b/schema)