---
title: "Start TOTP device enrollment"
method: POST
path: "/totp-devices/start-enrollment"
tags: ["TOTP devices"]
---

# Start TOTP device enrollment

`POST /totp-devices/start-enrollment`

Generates a shared secret and returns an OTPAuth URI to be displayed as a QR code. The returned enrollment id must be passed to finish-enrollment together with the first code generated by the authenticator app.

## Request body

- StartTotpEnrollmentRequestDto
  - `name` string, required

## Response `200`

OK

- StartTotpEnrollmentResponseDto
  - `id` integer
  - `totpAuthUri` string

---

[API](https://skmtc.dev/transferz/apis/authentication-api.md) · [All operations](https://skmtc.dev/transferz/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/transferz/authentication-api/revisions/73249fb480f2/schema)