SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Customer Auth

Confirm TOTP enrolment with a 6-digit code. Returns one-time recovery codes (shown once).

Confirm TOTP enrolment with a 6-digit code. Returns one-time recovery codes (shown once).

POSThttps://app.softsolz.uk/api/v1/services/customer-auth/users/{id}/mfa/enrol/confirm

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Body Params

codestringrequired

6-digit TOTP code from the authenticator app.

Response

Response Body

mfa_enabledbooleanTrue once enrolment is confirmed.
recovery_codesarray of stringsTen single-use recovery codes; only hashes are persisted.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/customer-auth/users/{id}/mfa/enrol/confirm \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"code": "123456"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"mfa_enabled": true,
"recovery_codes": [
"ABCD-EFGH-IJKL-MNOP"
]
}
}