Business guide · Zoho CRM

Sync Zoho CRM with Tookan

Connect your Zoho organization, choose how contacts move and check the results in Tookan.

All documentation

Zoho owns shared contact details

In continuous sync modes, Zoho owns linked contacts’ names, email, phones, description and address. Initial matching uses email only. After authorization, run a first batch to import contacts.

1. Connect the right organization

  1. Prepare activation

    Tookan support prepares the connection with your Zoho administrator. If Tookan says the connection needs configuration, contact support before continuing.

  2. Open Zoho CRM in Tookan

    Go to Settings > Integrations > Zoho CRM. Select a contact sync mode and your account region, such as EU for a European Zoho account.

  3. Authorize access in Zoho

    Click Connect Zoho CRM or Save settings. If authorization is requested, sign in, select the intended organization and environment, then approve to return to Tookan.

  4. Check the connected account

    Check the organization name, ID and environment displayed in Tookan. To use production data, select the production organization in Zoho.

Open Zoho CRM settings

2. Choose a contact sync mode

ModeBehavior
Import onceCopies Zoho details on the first match. Already imported contacts are not updated on later runs.
Keep Tookan updated from ZohoImports new Zoho contacts and refreshes their details on each run. Changes to shared details made in Tookan are replaced by Zoho values.
Exchange new contacts both waysAlso creates contacts in Zoho for Tookan records created after this mode was activated, with an email. Zoho then owns their details. Older Tookan contacts are not exported.

3. Understand contact ownership

Details of linked contacts
Zoho CRM

Create or edit names, email, phones, description and address.

Tookan

Receive these details on the next sync run.

In continuous modes, edit shared details in Zoho to keep the change.

New contact created in Tookan
Tookan

Create a contact with an email after activating both directions.

Zoho CRM

Create the record, then own its shared details.

  • Contacts and eight additional modules have independent settings: companies, products, notes, tasks, meetings, orders, tickets and emails.
  • Other Tookan-specific information, such as tags and application associations, remains managed in Tookan.
  • Deleting a Zoho contact does not delete the Tookan record. A record deleted in Tookan is reported and is not recreated automatically.

Configure the other modules

Choose modules in Settings > Integrations > Zoho CRM, save and grant the additional permissions in Zoho. Use “Load Zoho values” after authorization.

ModuleRule
CompaniesZoho owns companies and addresses. Initial matching uses the exact website; linked contacts receive their Zoho company.
ProductsChoose one master. SKUs must be unique in both catalogs. Existing records with different values are reported.
NotesEach platform owns the notes it created. Zoho contact notes are read-only in Tookan.
TasksEach platform owns its tasks. Select a destination colleague and the exact open/done Zoho statuses. Imported tasks are read-only.
MeetingsEach platform owns its meetings. Select the destination calendar. Imported meetings create no reminders or invitations.
OrdersMap statuses in each direction. Contacts and products must be linked and currencies must match. Payments remain in Tookan.
TicketsTickets use the Zoho Cases module. Map statuses and choose the origin used for new cases.
EmailsImport emails for linked contacts into an application with a plain text question. Email bodies and attachments can be viewed.
  • Set exact open/completed task statuses. For orders and cases, add a mapping for every status and direction. Values are never guessed.
  • New Tookan records are exported from module activation. The product catalog includes existing products. Linked records remain tracked by their identifiers.
  • Orders require linked contacts/products, matching currency and representable totals. Set the line price field and tax name for taxable exports. Header discounts, unsupported fees and ambiguous tax setups are reported without changing the order.
  • Recurring activities and meetings with multiple contacts or leads are reported. Deleted imported Zoho tasks and meetings are hidden in Tookan; other deletions do not propagate. Zoho deletion history is limited.
  • Email visibility depends on Zoho mail integration and sharing permissions. Attachments can be downloaded from the message while connected. They are not automatically added to contact documents.
  • Passes process batches per module. Continue through the scan and check each module report. Unknown creation results pause further creation until reconciliation to prevent duplicates.

4. Match contacts by email

  • For the first association, Tookan looks for a record with the same email in the same Tookan account. A unique match reuses the existing record.
  • Phone numbers are not matching keys. Several people can share a switchboard while keeping separate contact records.
  • If several Tookan records use the same email, the contact is reported for review. Resolve duplicates before running another pass.
  • Zoho contacts without email are reported. New Tookan contacts without email are not exported to Zoho.
  • After initial matching, Tookan keeps the Zoho record link: changing an email in Zoho updates the same Tookan contact.
  • If a new Tookan contact already exists in Zoho with the same email, the existing Zoho record is linked and its details take precedence.

5. Run and check a sync

  1. Run the first batch

    After connecting, click Import the next batch. Each run reads up to 200 Zoho contacts. Continue while more contacts remain.

  2. Review progress

    Check imported or linked contacts, updated details, new contacts exported and issues to review. The latest run time is displayed in UTC.

  3. Check a contact

    Open Contacts in Tookan and search for an email present in Zoho. In a continuous mode, edit a shared field in Zoho and check its arrival after the next run.

  4. Arrange automatic runs

    Ask Tookan support to enable or check automatic runs. The manual button remains available to verify an exchange. An active connection does not mean automatic runs are already enabled.

  • In both-directions mode, up to ten new Tookan contacts are processed per run after reading the Zoho contacts. Remaining contacts are processed on subsequent runs.

6. Troubleshoot common issues

The connection is active but no contacts appear

Run a first batch and check its counters. Confirm the organization is correct and the records are in Zoho’s Contacts module. Leads are not imported.

Several Tookan records match the same email

Resolve duplicates in the relevant account. The connector does not select an arbitrary match. Run another pass afterwards; in import-once mode, use Prepare another pass followed by Import the next batch.

The Tookan contact is already linked to another Zoho contact

Check whether two Zoho records share the same email and verify the contact data. If the issue remains, send support the Zoho ID shown in the issues list.

My changes in Tookan disappear

This is expected in continuous modes: Zoho owns shared details. Edit these fields in Zoho. Use Import once if you want to manage details independently after the initial copy.

A new Tookan contact is not exported

Check both-directions mode, the email and the creation date. Only records created after activation are eligible. Review export issues and confirm that the new Zoho authorization was completed.

Zoho requires an additional mandatory field

Your Zoho organization may require specific fields. Ask your Zoho administrator to complete the record or adjust its setup, then retry. Tookan support can help review the requirement.

Zoho quota was reached or Zoho is temporarily unavailable

Try again later. Tookan retains its progress and confirmed links so processing can resume.

Zoho asks for authorization again

Use Authorize the same organization again and complete the requested permissions. The selected region and organization must match the linked account.

7. Disable the connection

  • Use Disable connection in Tookan’s Zoho settings to stop exchanges.
  • Imported contacts remain in Tookan. Access tokens for this connection are removed from Tookan.
  • You can also revoke the application in your Zoho account. Authorizing the same organization again reuses existing links.

Return to Zoho CRM settings