X / ACCOUNTS & CHANNELS

TOTP

Manage optional two-factor authentication.

Syntax

X service Private message
/msg X TOTP STATUS | SETUP <password> | CONFIRM <code> | OFF|CODES <password> <code>

Required access

  • Signed in to X
  • TLS connection

How it works

Off until you enroll. TLS required. SETUP shows a private authenticator key; CONFIRM enables it.

Use AUTH account password code. For SASL PLAIN append :code to the password.

Enabled accounts must use PLAIN or AUTH; EXTERNAL alone cannot satisfy TOTP.

Eight single-use recovery codes are issued on confirmation. CODES replaces them.

OFF requires your password and a fresh authenticator or recovery code. Never post these secrets in a channel.

Options

STATUSSETUPCONFIRMOFFCODES

Parameters

password
A private account password. Replace the placeholder before sending privately.
code
The private confirmation, authenticator or recovery code requested by the service.

Ask the service for help

/msg X HELP TOTP

This command can contain private credentials or a confirmation code. Send it privately to the intended service. Copy buttons never execute commands.

If it is refused

  • TOTP requires a TLS connection.
  • Enrollment expired; use TOTP SETUP again.
  • Invalid TOTP code.

Reviewed 27 September 2026. Current service settings and access checks apply. For the service’s current help, use /msg X HELP TOTP.