---
title: "Create 2FA method"
method: POST
path: "/v1/2fa/methods"
tags: ["Two-Factor Authentication"]
---

# Create 2FA method

`POST /v1/2fa/methods`

Create a new two-factor authentication method. Requires MANAGE_2FA_METHODS access right.

## Request body

- TwoFactorMethodInput — Two-factor authentication method create/update request
  - `name` string, required — Method name
  - `driver` string, required — Driver name (e.g., "TOTP", "Message")
  - `description` string — Method description
  - `configuration` object — Driver-specific configuration

## Response `201`

2FA method created successfully

- TwoFactorMethod — Two-factor authentication method
  - `name` string — Method name (unique identifier)
  - `driver` string — Driver name (e.g., "TOTP", "Message")
  - `description` string — Method description
  - `isValid` boolean — Whether the method configuration is valid
  - `configuration` object — Driver-specific configuration (structure depends on the driver)

## Other responses

- `400` — Missing or invalid required fields, or unknown driver
- `403` — User does not have MANAGE_2FA_METHODS access right
- `409` — Method with this name already exists
- `500` — Database failure

---

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