Connect HubSpot to Tookan
Follow the steps in Tookan and HubSpot to choose which data to share and where to edit it.
All documentationThe principle in one sentence
Choose exchanges in Tookan; data then synchronises automatically. Each type of data has a platform that controls it.
1. Connect your account
-
In Tookan
Open HubSpot
In the sidebar, open Settings, then Integrations and HubSpot.
-
In Tookan
Choose your exchanges
Select the contact mode and the data your business needs, then click Connect HubSpot.
-
In HubSpot
Authorise the connection
Select your business’s HubSpot account, review requested permissions and complete the connection.
-
Back in Tookan
Check and save
Check the connected account number. Complete the settings and save.
2. Understand exchange directions
The arrow shows where data is created or edited, then where its copy appears.
Edit contact details here.
The record is created or updated automatically.
HubSpot controls contact details and the associated address. Edits to these details in Tookan may be replaced on the next synchronisation.
Create a new contact after enabling the option.
The new contact appears here.
HubSpot then controls its details. Enabling this option does not send all older Tookan contacts.
Import once
Copy contacts once without updating their details afterwards.
Keep Tookan up to date
Copy contact detail changes made in HubSpot into Tookan.
Exchange new contacts
Also add new contacts created in Tookan to HubSpot after activation.
3. Choose useful data
Enable the options you need. Available modules depend on your Tookan account.
Companies and addresses
HubSpot companies and addresses are copied into Tookan. The contact is linked to its primary HubSpot company.
Contact qualification
The HubSpot lifecycle stage becomes a contact tag in Tookan. Missing tags are created automatically; your other tags are kept.
Products
Choose one catalogue master: HubSpot or Tookan. SKU, name, description, sales price and purchase cost are exchanged.
Follow-up notes
Choose either direction or both. Edit a note on the platform where it was created. HubSpot notes are read-only in Tookan.
Tasks and appointments
Choose either direction or both. Each platform controls the records it creates. Reception settings are explained below.
Orders and tickets
Choose the direction and master platform, then map states between the two tools.
Logged emails
Emails linked to synchronised contacts in HubSpot become Tookan messages, including content and attachment access.
4. Choose contact owners
-
In Tookan
Prepare a responsibility type
The Super Admin creates types under Settings > Contact responsibility types, such as Primary or Reviewer.
-
In the HubSpot integration
Choose the type to use
Select the Tookan type representing the HubSpot owner. Also choose which assignment to keep if there is a conflict.
-
During synchronisation
Match by email
The HubSpot owner is matched to an active Tookan admin with the same email. Without a match, an existing local assignment is kept.
5. Map order and ticket states
Your workflows and states are those defined by your Tookan administrator. You choose how they correspond to HubSpot stages.
Choose the workflow and state to send.
Choose the destination pipeline and stage.
Leave Do not synchronise to exclude a state.
Choose the stage to import.
Choose the destination workflow and state.
Unmapped stages are not imported.
Each platform controls its own records
An order or ticket stays controlled by the platform where it was created.
Tookan controls all records
Changes in Tookan are copied to HubSpot. Enable both directions for this choice.
HubSpot controls all records
Changes in HubSpot are copied to Tookan. Enable both directions for this choice.
- HubSpot stage lists appear after connection and authorisation of the required access.
- Orders need a recognised contact, line products and currency.
- Naming a state Quote or Invoice does not automatically create a native HubSpot quote or invoice.
6. Receive tasks and appointments
The task is archived.
The task is completed.
These states correspond when the relevant sending direction is enabled.
For tasks
In Company account, the Super Admin selects the default admin. If none is selected, the first active Super Admin receives imported tasks.
For appointments
In Company account, the Super Admin selects the default calendar. HubSpot appointments are received in that calendar.
- Tasks without a contact or with one synchronised contact are supported. Tasks associated with a company or multiple contacts are ignored.
- Appointments without a contact or with one synchronised contact are supported. Those associated with multiple contacts are ignored.
- Edit task or appointment content on its original platform. Imported sticky notes can still be moved around the Tookan wall.
- An older Tookan task or appointment can be sent after an edit made once export is enabled. Older Tookan notes are not exported retrospectively.
7. Read emails in Tookan
-
In the HubSpot integration
Choose a Tookan app
Enable logged email import, then choose the app that receives messages. It needs a single-line text question for the subject.
-
On the contact page
Open the imported message
The subject fills the first single-line text question. Email content appears automatically and its plain-text version remains available in annotations.
-
In attachments
Open or associate with the contact
Open lets you view the file. Associate with contact stores it as a private document linked to that contact, if its format and size are allowed.
8. Check that it works
-
In HubSpot
Add an identifiable example
Create a contact with an email address or phone number. Then add a note, task or appointment according to your options.
-
Automatic synchronisation
Wait after saving
Exchanges are not instantaneous. You do not need to start any technical operation.
-
In Tookan
Compare the records
Find the contact and check details, company and expected records. If sending is enabled, also test a new record created in Tookan.
9. Find a solution
HubSpot refuses permissions
In HubSpot, a Super Admin opens Settings > Integrations > Connected Apps > Approved apps, then Tookan access. They allow the requested data. Return to Tookan and save to complete authorisation. Contact Tookan support if the required access is not offered.
The permission alert remains after returning to Tookan
Check the selected HubSpot account and that the requested permissions were granted. Save again in Tookan. If the alert remains, send its text to Tookan support.
HubSpot stages are not offered
Check the connection and permissions, then reload the HubSpot settings page in Tookan. The HubSpot account must have a pipeline for the relevant orders or tickets. Contact support if the lists remain empty.
An older task or appointment is not sent
Check the selected direction, then edit the record in Tookan and wait. Tookan contacts and notes that existed before activation are not automatically included in export.
An edit disappears
The master platform has reapplied its data. Edit the original there or ask the Tookan administrator to review the master choice.
Expected records do not appear
Check enabled options, the connected account and the contact link. For orders and tickets, check state mappings. For products, review Products to match. If settings look correct, contact Tookan support.
HubSpot says already authorised but Tookan shows no connection
Restart connection from the HubSpot integration in Tookan and check the selected account. Contact Tookan support if the return still does not confirm the connection.
What should I send Tookan support?
Include your company name, the screen, exchange direction, expected record name, test time and any error message. A screenshot may help. Do not send passwords.