---
title: "Update or create a configuration for the given MFA method"
method: POST
path: "/identity/mfa/method/totp/{method_id}"
tags: ["identity"]
---

# Update or create a configuration for the given MFA method

`POST /identity/mfa/method/totp/{method_id}`

## Request body

- IdentityMfaMethodTotpRequest
  - `algorithm` string — The hashing algorithm used to generate the TOTP token. Options include SHA1, SHA256 and SHA512.
  - `digits` integer — The number of digits in the generated TOTP token. This value can either be 6 or 8.
  - `issuer` string — The name of the key's issuing organization.
  - `key_size` integer — Determines the size in bytes of the generated key.
  - `max_validation_attempts` integer — Max number of allowed validation attempts.
  - `method_id` string — The unique identifier for this MFA method.
  - `period` integer — The length of time used to generate a counter for the TOTP token calculation.
  - `qr_size` integer — The pixel size of the generated square QR code.
  - `skew` integer — The number of delay periods that are allowed when validating a TOTP token. This value can either be 0 or 1.

## Response `200`

OK

---

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