auth.signIn

auth.signIn

No description provided by the pinned schema.

Signature

auth.signIn#8d52a951 flags:# phone_number:string phone_code_hash:string phone_code:flags.0?string email_verification:flags.1?EmailVerification = auth.Authorization;

Result type

auth.Authorization

Parameters

Name	Type	Flag	Default	Description
flags	#	flag word	—	No description provided by the pinned schema.
phone_number	string	—	—	No description provided by the pinned schema.
phone_code_hash	string	—	—	No description provided by the pinned schema.
phone_code	flags.0?string	flags.0	—	No description provided by the pinned schema.
email_verification	flags.1?EmailVerification	flags.1	—	No description provided by the pinned schema.

Flags

Parameter	Bit	Meaning
phone_code	0	Controlled by flags; present when this bit is set.
email_verification	1	Controlled by flags; present when this bit is set.

Python binding

from miniproto.raw.functions import AuthSignIn

Public access: miniproto.raw.functions.AuthSignIn.

Safe usage shape

from miniproto.raw.functions import AuthSignIn

# Naming the raw request class is local only; it performs no I/O or network request.
request_type = AuthSignIn

Result family

auth.Authorization

RPC errors

Code	Error	Description
400	BUSINESS_CONNECTION_NOT_ALLOWED	This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we’re a user, and users cannot invoke methods over a business connection; (2) we’re a bot, but business mode was disabled in @botfather or (3); we’re a bot, but this method cannot be invoked over a business connection.
400	PHONE_CODE_EMPTY	phone_code is missing.
400	PHONE_CODE_EXPIRED	The phone code you provided has expired.
400	PHONE_CODE_INVALID	The provided phone code is invalid.
400	PHONE_NUMBER_INVALID	The phone number is invalid.
400	PHONE_NUMBER_UNOCCUPIED	The phone number is not yet being used.
406	PHONE_NUMBER_INVALID	The phone number is invalid.
406	UPDATE_APP_TO_LOGIN	Please update your client to login.
500	AUTH_RESTART	Restart the authorization process.
500	SIGN_IN_FAILED	Failure while signing in.

Accepted types

EmailVerification Known selected constructors: emailVerificationApple, emailVerificationCode, emailVerificationGoogle

Returned types

auth.Authorization Known selected constructors: auth.authorization, auth.authorizationSignUpRequired

Related methods

account.verifyEmail, auth.checkPassword, auth.finishPasskeyLogin, auth.importAuthorization, auth.importBotAuthorization, auth.importWebTokenAuthorization, auth.recoverPassword, auth.signUp

Availability evidence

• unauthenticated allowed
• user only

Provenance

• layer: 228
• structural source: tdlib
• canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
• prose merge precedence: TDLib → Telegram Desktop → Core JSON
• source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.

Source-diff notes

• tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
• tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery