Article Information
This article applies to the following ZCS versions.
ZCS 7.0
ZCS 6.0

<< Back to Zimbra REST API Reference

REST API Method: Import Contacts

Import contacts. The default folder is "contacts" but user-defined folders are also supported.

URL

http://localhost:7070/home/john.doe/contacts?{params}

Go to Command Format

HTTP Method

POST

Formats

csv,vcf (Go to Response Formats)

Requires Authentication

true (Go to Authentication)

Parameters

• fmt. Required. The import format. Defaults to csv.

Usage Examples

The following examples show using the curl utility to post a file to the REST command. Be sure to replace {username} and {password} with the account username and password.

Import contacts from CSV format:

curl -{username}:{password} --upload-file /tmp/mycontacts.csv http://localhost:7070/home/john.doe/contacts?fmt=csv

Import contacts from VCF format:

curl -{username}:{password} --upload-file /tmp/mycontact.vcf http://localhost:7070/home/john.doe/contacts?fmt=vcf

Import contacts from CSV format into the user-defined folder "Contacts > MyBusinessContacts:

curl -{username}:{password} --upload-file /tmp/mycontacts.csv http://localhost:7070/home/john.doe/contacts/mybusinesscontacts?fmt=csv

Import contacts from CSV format into the user-defined folder "SalesContacts:

curl -{username}:{password} --upload-file /tmp/mycontacts.csv http://localhost:7070/home/john.doe/salescontacts?fmt=csv