ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiAuth

Start 2FA setup — returns secret + QR code

POST
/api/v1/auth/2fa/setup

Generates a pending TOTP secret. 2FA is NOT active until enable verifies the first code. Fails if 2FA is already enabled (disable first).

Authorization

bearer

Header Parameters

X-API-Version?string

API version for header-based versioning

Default"1"
Value in"1""2"

Response Body

Setup material

Example Request
curl -X POST 'http://localhost:3001/api/v1/auth/2fa/setup'
Example Response200
Empty