Sync Zoho CRM with Tookan
Connect your Zoho organization, choose how contacts move and check the results in Tookan.
All documentationZoho 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
- Prepare activation
Tookan support prepares the connection with your Zoho administrator. If Tookan says the connection needs configuration, contact support before continuing.
- 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.
- 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.
- Check the connected account
Check the organization name, ID and environment displayed in Tookan. To use production data, select the production organization in Zoho.
2. Choose a contact sync mode
| Mode | Behavior |
|---|---|
| Import once | Copies Zoho details on the first match. Already imported contacts are not updated on later runs. |
| Keep Tookan updated from Zoho | Imports 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 ways | Also 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
Create or edit names, email, phones, description and address.
Receive these details on the next sync run.
In continuous modes, edit shared details in Zoho to keep the change.
Create a contact with an email after activating both directions.
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.
| Module | Rule |
|---|---|
| Companies | Zoho owns companies and addresses. Initial matching uses the exact website; linked contacts receive their Zoho company. |
| Products | Choose one master. SKUs must be unique in both catalogs. Existing records with different values are reported. |
| Notes | Each platform owns the notes it created. Zoho contact notes are read-only in Tookan. |
| Tasks | Each platform owns its tasks. Select a destination colleague and the exact open/done Zoho statuses. Imported tasks are read-only. |
| Meetings | Each platform owns its meetings. Select the destination calendar. Imported meetings create no reminders or invitations. |
| Orders | Map statuses in each direction. Contacts and products must be linked and currencies must match. Payments remain in Tookan. |
| Tickets | Tickets use the Zoho Cases module. Map statuses and choose the origin used for new cases. |
| Emails | Import 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
- Run the first batch
After connecting, click Import the next batch. Each run reads up to 200 Zoho contacts. Continue while more contacts remain.
- Review progress
Check imported or linked contacts, updated details, new contacts exported and issues to review. The latest run time is displayed in UTC.
- 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.
- 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.