The address sync imports your onOffice address book into the central platform address book. All tools then read the same contact state, and you maintain the mapping only once.
You find this area under Settings → Integrations → onOffice, in the "Addresses from onOffice" frame. It requires an existing connection (see the connection guide).
One address book for all tools
What the sync does
Read addresses
The platform reads your address book from onOffice page by page (200 per page). Even an address book with many thousands of entries is processed in full: the first run fetches as much as possible immediately, the rest continues in the background.
Map fields
Each onOffice address field is imported into the matching platform field per your mapping (first name, last name, email, phone, customer number and so on).
Create or update
New contacts are created, already imported ones updated. The sync is repeatable and never duplicates (dedup via the onOffice record id).
Remove deleted contacts
Contacts that no longer exist in onOffice disappear from the address book as well, together with everything tools derived from them (for example briefings and findings in DB-Leads). This only happens at the end of a complete run and only after asking onOffice about each contact individually.
Deleted contacts
When you delete a contact in onOffice, the next sync removes it on our side as well. Three rules make sure a disturbed run never turns into a mass deletion:
- Only after a complete run. A sync that aborts removes nothing. A contact only becomes a candidate once a run has read the entire address book without seeing it.
- Every candidate is verified individually. Before a contact goes, the platform asks onOffice specifically for that record. If onOffice still delivers it, it stays. If onOffice answers with an error, it stays as well and the run says so in its log.
- A safety limit. If more than 50 contacts or more than ten percent of the address book go missing at once, the sync deletes nothing. It stops, reports the number to owners and admins, and the section shows a notice with the "Confirm deletion" button. Only with that confirmation does the next run remove the contacts, again after verifying each one with onOffice.
Field mapping
Sensible default mappings (first name, last name, email, phone, customer number) ship out of the box, because onOffice field names vary per broker. Review and extend them in the collapsible "Field mapping" area. After saving it collapses; reopen it via "Show".
The mapping is deliberately simple: onOffice field to platform field, without direction. The sync reads only. Writing back to onOffice happens exclusively through explicit features (for example the acquisition write-back of DB-Leads with its own field configuration).
Details on mapping and how unknown fields are handled are in the field mapping guide.
Start the first sync
Review the field mapping
Open the "Field mapping" area, review the defaults, save.
Sync now
Click "Sync now". The result arrives as a notification ("X new, Y updated").
After that the sync runs automatically every day.