# Create TOTP (beta)

**POST /v1/auth/totps/create**

Initiates a TOTP authenticator for the specified user.

## HTTP Request

`POST /v1/auth/totps/create`

## Returns

A successful response returns an `TOTP` object.


## Servers
- Production: https://api.moonkey.fun (Production)


## Authentication methods
- Authorization


## Parameters



### Body: application/json (object)

- **user_id** (string)
  `Required` Unique user ID to associate the TOTP with.
- **expires_in** (string)
  `Optional` Set expiration time in minutes from now for TOTP instance that must be verified within a given timeframe to be activated. Must be between 5 to 2160 minutes (36 hours), defaults to 30 minutes if not provided.


## Responses
### 200
OK

#### Body: application/json (object)
- **user_id** (string)

- **secret** (string)

- **totp_id** (string)

- **recovery_codes** (array[string])

- **qr_base64** (string)



[Powered by Bump.sh](https://bump.sh)