POST
Set up 2FA (start)
Step 1 of the 2FA path during first-time security setup. (To add 2FA to an already-signed-in user later, see Start 2FA setup.) Send the session_token from the SECURITY_SETUP_REQUIRED challenge. You get back a secret and an otpauth:// qr_uri — render the QR code so the user can add it to their authenticator app. No bearer token needed. Then confirm with the first code the app shows.

Headers

x-program-id
string
required

Identifies the program. Can also be sent as the programId query parameter.

Body

application/json
session_token
string
required

From the SECURITY_SETUP_REQUIRED challenge.

Example:

"3f1c2e8a-9b4d-4e6f-8a1b-2c3d4e5f6a7b"

Response

TOTP secret and QR code

success
boolean
Example:

true

data
object