Enable 2FA

PUT

/v2/user/mfa/enable

Last modified:2025-09-01 18:52:30

Initiates the 2FA (Two-Factor Authentication) enabling process, serving as a pre-enable step.
This phase involves validating the correctness of the provided phone number, specifically for
SMS OTP (One-Time Password), and dispatching the verification code.

To finalize the activation, it is necessary to confirm the 2FA installation. This confirmation is achieved
by utilizing the /v2/user/mfa/verify_installation endpoint, allowing users to validate the 2FA setup,
whether it involves SMS or TOTP (Time-Based One-Time Password) authentication methods.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200OK

application/json

2FA enabled

Body

🟠401Unauthorized

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/v2/user/mfa/enable?method&phone_number&country_code' \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'

Response Example

200 - sms_success

{
    "status": "queued"
}

Modified at 2025-09-01 18:52:30

Sync the a port lists

Verify 2FA installation