# Creating a Virtual MFA Device

#### Function

This API is provided for IAM users to create a virtual MFA device.

#### URI

POST /v3.0/OS-MFA/virtual-mfa-devices

#### Request Parameters

Table 1 Parameters in the request header
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
X-Auth-Token | Yes | String | Token (no special permission requirements) of the IAM user corresponding to the user_id specified in the request body.

Table 2 Parameters in the request body
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
virtual_mfa_device | Yes | object | MFA device information.

Table 3 virtual_mfa_device
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
name | Yes | String | Device name. Minimum length: 1 character Maximum length: 64 characters
user_id | Yes | String | ID of the user for whom you will create the MFA device.

#### Response Parameters

Status code: 201

Table 4 Parameters in the response body
Parameter | Type | Description
--- | --- | ---
virtual_mfa_device | object | MFA device information.

Table 5 virtual_mfa_device
Parameter | Type | Description
--- | --- | ---
serial_number | String | Serial number of the MFA device.
base32_string_seed | String | Base32 seed, which a third-party system can use to generate a CAPTCHA code.

#### Example Request

    POST https://sample.domain.com/v3.0/OS-MFA/virtual-mfa-devices

    {
      "virtual_mfa_device" : {
        "name" : "{device_name}",
        "user_id" : "09f99d8f6a001d4f1f01c00c31968..."
      }
    }

#### Example Response

Status code: 201

The request is successful.

    {
      "virtual_mfa_device": {
        "serial_number": "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}",
        "base32_string_seed": "{string}"
      }
    }

#### Status Codes

Status Code | Description
--- | ---
201 | The request is successful.
400 | The request is invalid.
401 | Authentication failed.
403 | You do not have permission to perform this action.
409 | A conflict occurs when the requested resource is saved.
500 | A system error occurred.

Parent topic: User Management