MadelineProtoDocs/old_docs/API_docs_v18/methods/contacts.importContacts.md

title: contacts.importContacts description: 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. image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png redirect_from: /API_docs/methods/contacts_importContacts.html

Method: contacts.importContacts

Back to methods index

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.

Parameters:

Name	Type	Description	Required
contacts	Array of InputContact	List of contacts to import	Yes
replace	Bool		Yes

Return type: contacts.ImportedContacts

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();

$contacts.ImportedContacts = $MadelineProto->contacts->importContacts(['contacts' => [InputContact, InputContact], 'replace' => Bool, ]);

Or, if you're into Lua:

contacts.ImportedContacts = contacts.importContacts({contacts={InputContact}, replace=Bool, })

Errors

Code	Type	Description
406	AUTH_KEY_DUPLICATED	An auth key with the same ID was already generated