Connect Pipedrive to Tookan
Link people and organisations, then choose how notes, tasks, meetings, products and orders move between your tools.
All documentationStart with contacts
One Pipedrive company connects to one Tookan account. Preview matches before enabling synchronisation. Other modules remain off until you choose their direction.
1. Connect the right account
- Prepare access
Your administrator prepares a private Pipedrive app and its permissions in the Developer Hub. The connection must also be configured on the Tookan server.
- Authorise Pipedrive
In Tookan, open Settings > Integrations > Pipedrive and select Connect Pipedrive. Choose the right Pipedrive company and approve the requested permissions.
- Check the company
Back in Tookan, check the connected company name. Another Pipedrive company cannot silently replace an existing connection.
2. Preview people and organisations
- Run the preview
Select Preview matches. The preview shows a sample of people and organisations without changing Tookan.
- Review records needing attention
Fix missing names or contact details, duplicates and records already managed by another integration. A pending organisation can prevent a person from being linked.
- Enable synchronisation
Enable Pipedrive, save, then select Synchronise now. Organisations are processed before people.
3. Set directions for notes and activities
| Data | Setting in Tookan |
|---|---|
| Notes | Choose no sync, Pipedrive to Tookan, Tookan to Pipedrive or both directions. Select a Tookan account to receive imported notes. |
| Tasks | Choose the direction and an active Tookan account for imported tasks. |
| Meetings | Choose the direction and destination Tookan calendar. Pipedrive meetings need a date, time and duration. |
4. Set up the catalogue and orders
- Products
Choose which platform controls the catalogue. Matching requires a unique product code, consistent data and the Tookan order currency.
- Deals and orders
Choose the sync direction. Load Pipedrive stages, then map stages and statuses to Tookan order states for every enabled direction.
- Check limitations
The contact and products must already be linked. Subscriptions, variants, discounts, tax inclusive prices and some charges are not automatically converted. This sync does not trigger payments or invoices.
5. Check results and resolve issues
- Read the last run
Check its time and the counts of created, updated, flagged and failed records. A partial import resumes on a later run.
- Review flagged records
Flagged people, activities, products and orders appear with a reason. Correct the source data, then run synchronisation again.
- Check permissions
If a module lacks permissions, add the required access in Pipedrive and reconnect the account in Tookan. Export needs broader access than read only sync.
A person is missing?
Check their name, email address or phone number, and any linked organisation. Review the preview and flagged records.
An order is missing?
Check state mappings, currency, linked contact and products, and line totals.
The connection needs fresh authorisation?
Reconnect Pipedrive from Tookan. If it still fails, send support the displayed message and last run time without sharing credentials.
6. Disconnect Pipedrive
Use Disconnect in Pipedrive settings to stop exchanging data. Existing Tookan records and their links are retained. Check active modules before reconnecting.