# Connect onOffice

<Lead>
Set up the onOffice integration once, centrally, under
**Settings → Integrations → onOffice**. After that every tool that uses onOffice
(for example Leads) shares the same connection automatically. No tool asks for
its own credentials.
</Lead>

## Ready in three steps

<Steps>
<Step title="Connect">
Create an API user in onOffice, grant the rights, generate a token and secret,
then test the connection in the platform.
</Step>
<Step title="Sync addresses and objects">
Your address book and your properties are imported and then reconciled
automatically every day.
</Step>
<Step title="Review fields">
The field mapping ships with sensible defaults. Review, extend if needed, save.
The status is detected automatically.
</Step>
</Steps>

## Detailed guides

<CardGrid>
<Card href="/help/integrations/onoffice/verbindung" title="Establish the connection" eyebrow="Step 1">
API user, rights, token and secret, connection test and data-flow switches.
</Card>
<Card href="/help/integrations/onoffice/adressen" title="Address sync" eyebrow="Step 2">
The central address book every tool reads its contacts from.
</Card>
<Card href="/help/integrations/onoffice/objekte" title="Object sync" eyebrow="Step 2">
Import your properties in full and with the correct status.
</Card>
<Card href="/help/integrations/onoffice/feldzuordnung" title="Field mapping" eyebrow="Deep dive">
Map fields, add custom fields, translate values.
</Card>
<Card href="/help/integrations/onoffice/status" title="Detect status" eyebrow="Deep dive">
How the object status is determined and how to attach your own value list.
</Card>
<Card href="/help/integrations/onoffice/problembehebung" title="Troubleshooting" eyebrow="Help">
Fixes for the most common sync problems.
</Card>
</CardGrid>

## Core principles

<DefinitionList>
<DefItem term="One book for all tools">
Addresses and objects are synced centrally. Every tool reads the same state and
you maintain the mapping only once.
</DefItem>
<DefItem term="Complete, not partial">
The entire inventory is imported. Filter by status in the gallery instead of
missing objects.
</DefItem>
<DefItem term="Nothing is lost">
Unmapped fields are kept in full in the object or contact details. You can add a
mapping later and re-sync at any time.
</DefItem>
<DefItem term="Stored securely">
Credentials are encrypted server-side and never shown again. Verifiable and
revocable at any time.
</DefItem>
</DefinitionList>
