# Set up Contact Synchronization from Zoho CRM

Once Zoho CRM (your Customer Relationship Management system) is connected to Cloud Voice, you can turn on automatic contact synchronization. This copies your Zoho CRM contacts into a dedicated Cloud Voice phonebook in a single direction, so incoming and outgoing calls can be matched to the right person without maintaining a separate address book.

## Before you begin

Finish connecting Cloud Voice to Zoho CRM. Synchronization is only available after the integration is in place.

## Turn on contact synchronization

1. Sign in to the Cloud Voice management portal and open **Integrations > CRM**.
2. On the CRM integration page, enable **Synchronize Contacts Automatically**.
3. Open the **Synchronize Contacts From** drop-down and choose which Zoho CRM contact types you want to bring across.

   ![Toggle for automatic synchronization with the contact-type selector](/images/pbx/synchronize-contact-automatically.png)

4. Use the **Synchronize to Phonebook** drop-down to pick the destination. Select an existing empty phonebook, or create a new one to hold the contacts coming from Zoho CRM.

   :::note
   Contacts can only be synced into an empty phonebook.
   :::

   ![Destination phonebook selector for synced contacts](/images/pbx/synchronize-to-phonebook.png)

5. Set **Always Query CRM** to control whether Cloud Voice looks up contacts in the CRM in real time.

   
   ![Cloud Voice, Always Query CRM setting on the integration page](/images/pbx/always-query-crm.png)

   - Enabled: Cloud Voice queries the CRM live for contact details and lets the associated extension users search Zoho CRM contacts as they dial in the Cloud Voice App.
   - Disabled: Cloud Voice only queries the CRM when no match is found in your company contacts.

   :::caution
   Turning on live queries raises your CRM API (Application Programming Interface) usage, so keep an eye on your quota to avoid hitting a limit. Real-time search is also unavailable when number masking is turned on.
   :::

6. Click **Save**.

## What happens next

Go to **Contacts > Phonebooks** and you will see a CRM label on the phonebook you selected.

![CRM label shown on a phonebook](/images/pbx/crm-tag.png)

![Synced phonebook listed among company phonebooks](/images/pbx/crm-phonebook.png)

When someone receives an inbound call from one of the selected Zoho CRM contact types, or dials out to such a contact, Cloud Voice looks up the caller and copies the matched details from the CRM into the linked phonebook automatically.

:::note
- This is a one-way sync into Cloud Voice, so the linked phonebook and its synced contacts are read-only.
- When a synced contact changes in Zoho CRM, the update reaches Cloud Voice within 30 minutes.
:::

If your existing Zoho CRM contacts do not appear after saving, review the CRM integration troubleshooting steps for why a sync can fail.