telegram api method · layer 229 · #8d52a951

auth.signIn

usable by users

Signs in a user with a validated phone number.

definition

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

parameters

nametypedescription
flags#Flags, see TL conditional fields
phone_numberstringPhone number in the international format
phone_code_hashstringSMS-message ID, obtained from auth.sendCode
phone_codeflags.0?stringValid numerical code from the SMS-message
email_verificationflags.1?EmailVerificationEmail verification code or token

returns

auth.Authorization

errors (10)

codeerrordescription
400BUSINESS_CONNECTION_NOT_ALLOWEDThis 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.
400PHONE_CODE_EMPTYphone_code is missing.
400PHONE_CODE_EXPIREDThe phone code you provided has expired.
400PHONE_CODE_INVALIDThe provided phone code is invalid.
400PHONE_NUMBER_INVALIDThe phone number is invalid.
400PHONE_NUMBER_UNOCCUPIEDThe phone number is not yet being used.
406PHONE_NUMBER_INVALIDThe phone number is invalid.
406UPDATE_APP_TO_LOGINPlease update your client to login.
500AUTH_RESTARTRestart the authorization process.
500SIGN_IN_FAILEDFailure while signing in.

history

present in layers 2–229 · constructor id changed 1×

idlayers
#bcd515812–144
#8d52a951145–229