Bulk creates, or bulk updates, contacts


Active contact imports are limited to four

If you exceed this limit, you'll get the 'too many active imports' error.

This method bulk creates, or bulk updates, contacts in the import file.

The import format can either be CSV or Excel. It must include one column called 'Email' or the translated equivalent if your account is using a language other than English. Any other columns will attempt to map to your custom contact data fields.

There is a 10MB file upload limit; if your file is larger than this, please break your upload into separate files.

The ID of the returned object can be used to query import progress.

SOAP action:


Input and output parameters

Input parameters

  • Data - required; file
  • dataType - required; string

Output parameters

  • ImportContactsResult
    • Id - GUID
    • Status - string ('Finished', 'NotFinished', 'RejectedByWatchdog', 'InvalidFileFormat', 'ExceedsAllowedContactLimit', 'Unknown', 'Failed')


using (var client = new ApiServiceClient())
	client.ClientCredentials.UserName.UserName = "username";
	client.ClientCredentials.UserName.Password = "password";

	var path = @"contacts.csv";
	var data = File.ReadAllBytes(path);
	var dataType = "csv";
	var contactImport = client.ImportContacts(data, dataType);