contacts.addContact

Add an existing telegram user as contact.

Use contacts.importContacts to add contacts by phone number, without knowing their Telegram ID.

 Method schema is available as of layer 102. Switch ยป

Parameters

Name Type Description
flags # Flags, see TL conditional fields
add_phone_privacy_exception flags.0?true Allow the other user to see our phone number?
id InputUser Telegram ID of the other user
first_name string First name
last_name string Last name
phone string User's phone number, may be omitted to simply add the user to the contact list, without a phone number.

Result

Updates

Possible errors

Code Type Description
400 CHANNEL_PRIVATE You haven't joined this channel/supergroup.
400 CONTACT_ID_INVALID The provided contact ID is invalid.
400 CONTACT_NAME_EMPTY Contact name empty.
400 MSG_ID_INVALID Invalid message ID provided.

Related pages

contacts.importContacts

Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.

Use contacts.addContact to add Telegram contacts without actually using their phone number.