How does the sync.blue® address book work?

Benefits

sync.blue® typically does not store contacts independently and instead synchronizes them live between two accounts, such as a Microsoft 365 account (groupware) and a Placetel account (telephone system).

In some scenarios, however, it is necessary for sync.blue® to deliberately serve as an online contact storage and make the contacts available for download in a variety of formats on demand:

• Phone book for IP phones: Contacts from a specific address book source, such as Microsoft 365, should be made available as a phone book for an IP phone (e.g., snom or Yealink).
• Merging multiple accounts: Contacts from different accounts such as Microsoft 365, Apple iCloud, and Google Contacts should be merged and made available for a separate corporate application without duplicates.
• Push instead of pull: Contacts cannot be retrieved from an internal corporate application by sync.blue® and should be pushed from the internal network into the sync.blue® address book.

Technology

How do contacts get into the sync.blue® address book?

sync.blue® address book as a connection destination

Select the sync.blue® address book as the destination in a classic sync.blue® connection (e.g., source "Microsoft 365" and destination "sync.blue® address book").

Multiple connections can be created with the same sync.blue® address book account as the destination.

sync.blue® Address Book as Push Destination

1. Create a local CSV file according to these instructions.

2. Push this CSV file named contacts_5.csv to the sync.blue® Address Book e.g., via cURL:

Example for macOS:

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

Example for Windows: 

curl --insecure -F "file=@contacts_v5.csv" ^
-H "Authorization: YOUR_API_KEY" ^
https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID from your sync.blue® address book>/upload_csv

Technical requirements:

• Request: POST
• Form type: multipart/form-data
• Parameter name of the CSV file: file

Security and data protection

• Contacts are only available via HTTPS (SSL-encrypted)
• Contacts are only available if the personal API key is known

More on this here.