# Method: contacts.addContact

Back to methods index

Add an existing telegram user as contact.

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

# Parameters:

Name Type Description Required
add_phone_privacy_exception Bool Allow the other user to see our phone number? Optional
id Username, chat ID, Update, Message or InputUser Telegram ID of the other user Optional
first_name string First name Yes
last_name string Last name Yes
phone string User’s phone number Yes

# Return type: Updates

# Can bots use this method: NO

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$Updates = $MadelineProto->contacts->addContact(['add_phone_privacy_exception' => Bool, 'id' => InputUser, 'first_name' => 'string', 'last_name' => 'string', 'phone' => 'string', ]);

Or, if you’re into Lua:

Updates = contacts.addContact({add_phone_privacy_exception=Bool, id=InputUser, first_name='string', last_name='string', phone='string', })

# Errors

Code Type Description
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
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.