MadelineProtoDocs/old_docs/API_docs_v42/methods/contacts.addContact.md
2020-09-12 12:47:38 +02:00

2.2 KiB

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