Initiate MFA Setup

POST

https://api-dev.synswi.com/identity/mfa/setup

Start enabling a new MFA method (email or authenticator).
Requires current password for confirmation.
For email: sends a verification code to the user's email.
For authenticator: returns a TOTP secret and otpauth URI for QR code scanning.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "method": "email",
    "password": "{{password}}"
}

Responses

🟢200

application/json

Setup initiated

Body

Example

{
    "message": "Email verification code sent. Please check your inbox.",
    "mfaToken": "mfa_abc123"
}

🟠400

🟠401

🟠403

🟠404

🟠429

get settlement entries

Verify MFA Setup