Set up Time-based One-Time Password (TOTP) for Two-Factor Authentication (2FA)

Initiate and configure two-factor authentication (2FA) for your account using a Time-based One-Time Password (TOTP). It generates a QR code and a manual entry key needed to add HostUp to your authenticator app. The endpoint returns a requestId for follow-up calls.

Headers

Accept Example

Content-Type Example

Body

required

application/json

methodName string required

Responses

200

success boolean

timestamp string

requestId string

data object

400

error string

message string

code string

timestamp string

requestId string

POST https://cloud.hostup.se/api/mfa/setup/totp

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/mfa/setup/totp" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "methodName": "string"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "qrCode": "string",
    "manualEntryKey": "string",
    "label": "string",
    "issuer": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "qrCode": {
          "type": "string"
        },
        "manualEntryKey": {
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "issuer": {
          "type": "string"
        }
      }
    }
  }
}

Request Body

{
  "methodName": "string"
}