> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Create TOTP credential

> Creates a new TOTP secret for two-factor authentication. Returns the secret and configuration details needed to set up an authenticator app.



## OpenAPI

````yaml api-reference/auth.yaml post /users/totp/create
openapi: 3.0.3
info:
  title: auth
  description: >-
    The Auth Service is the single source of truth for all accounts and their
    permissions, managing authentication and access control across the platform.
    It maintains efficiency at scale by issuing access tokens to accounts when
    they log into the platform and providing public keys for other services to
    verify them.
  version: 1.0.0
servers:
  - url: https://auth.platform.arb.inc
security: []
tags:
  - name: /
  - name: authenticate
  - name: internal
  - name: organizations
  - name: sessions
  - name: users
paths:
  /users/totp/create:
    post:
      tags:
        - users
      summary: Create TOTP credential
      description: >-
        Creates a new TOTP secret for two-factor authentication. Returns the
        secret and configuration details needed to set up an authenticator app.
      operationId: createTOTP
      responses:
        '200':
          description: Successfully created TOTP credential
          content:
            application/json:
              schema:
                type: object
                properties:
                  secret:
                    type: string
                    description: Base32-encoded TOTP secret
                    example: JBSWY3DPEHPK3PXP
                  issuer:
                    type: string
                    description: Issuer name for the authenticator app
                    example: Arb
                  accountName:
                    type: string
                    description: Account name displayed in authenticator app
                    example: user@example.com
                  algorithm:
                    type: string
                    description: TOTP algorithm
                    example: SHA1
                  digits:
                    type: integer
                    description: Number of digits in TOTP code
                    example: 6
                  period:
                    type: integer
                    description: Time period in seconds for TOTP generation
                    example: 30
        '409':
          description: Credential already exists
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````