How does the CSV import of the sync.blue® address book work?

The CSV import allows you to quickly and easily transfer contacts into the sync.blue® address book.

1. Enable token access: In the settings of your sync.blue® address book, activate the Token Access option. You will receive a personal API token that you need for authentication during the import.
2. Create CSV file: Create a local CSV file following this guide.
3. Upload CSV file: Send your prepared CSV file via HTTP POST to the following URL: https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID of the sync.blue® address book>/upload_csv and set the following HTTP header: Authorization: <Token>

Example with cURL

curl -F 'file=@contacts_v5.csv' \
  -H 'Authorization: YOUR_API_KEY' \
  https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID of the sync.blue® address book>/upload_csv

Video Tutorial

🎥 In this YouTube video, we show you how to import CSV files into the sync.blue® ADDRESS BOOK.

Optional: Mirror mode

With the attached parameter ?import_mode=mirror, unchanged contacts remain untouched, thus do not receive a new version and do not trigger the re-sending of digital business cards:

curl -F 'file=@contacts_v5.csv' \
  -H 'Authorization: YOUR_API_KEY' \
  https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID of the sync.blue® address book>/upload_csv?import_mode=mirror