Generate two-factor authentication secret

Returns a fresh TOTP shared secret for enrolling a user in two-factor authentication. Call this once, during initial MFA setup for a user, then register the returned secretBase32Encoded value with POST /mfa/enable. Store it securely: the same secret is required to generate the TOTP code for every subsequent login, and this endpoint returns a different secret on every call. Calling it does not enrol anything or change the user.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Headers
string
required

Your environment API key, sent raw with no "Bearer" prefix. This endpoint proxies directly to the identity provider and does not accept a JWT: sending "Bearer " returns 401. The JWT from POST /mfa/login is used on the business endpoints, not here.

Responses

400

Missing required request parameters: [Authorization]. Returned by the gateway request validator when the Authorization header is absent, before the request reaches the identity provider.

401

Invalid Authorization Header. Returned when the header is present but is not a valid API key, including when a Bearer JWT is sent instead of the raw key.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json