MadelineProtoDocs/old_docs/API_docs_v42/methods/contacts.addContact.md

title: contacts.addContact description: Add an existing telegram user as contact. Use contacts.importContacts to add contacts by phone number, without knowing their Telegram ID. image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png redirect_from: /API_docs/methods/contacts_addContact.html

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');
$MadelineProto->start();

$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