Business guide · HubSpot

Connect HubSpot to Tookan

Follow the steps in Tookan and HubSpot to choose which data to share and where to edit it.

All documentation

The 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

  1. In Tookan

    Open HubSpot

    In the sidebar, open Settings, then Integrations and HubSpot.

  2. In Tookan

    Choose your exchanges

    Select the contact mode and the data your business needs, then click Connect HubSpot.

  3. In HubSpot

    Authorise the connection

    Select your business’s HubSpot account, review requested permissions and complete the connection.

  4. Back in Tookan

    Check and save

    Check the connected account number. Complete the settings and save.

Open my HubSpot integration

2. Understand exchange directions

The arrow shows where data is created or edited, then where its copy appears.

Contact details: HubSpot to Tookan
HubSpot

Edit contact details here.

Tookan

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.

Optional: new Tookan contacts to HubSpot
Tookan

Create a new contact after enabling the option.

HubSpot

The new contact appears here.

HubSpot then controls its details. Enabling this option does not send all older Tookan contacts.

An initial import

Import once

Copy contacts once without updating their details afterwards.

HubSpot controls

Keep Tookan up to date

Copy contact detail changes made in HubSpot into Tookan.

Creation on either side

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.

HubSpot to Tookan

Companies and addresses

HubSpot companies and addresses are copied into Tookan. The contact is linked to its primary HubSpot company.

HubSpot to Tookan

Contact qualification

The HubSpot lifecycle stage becomes a contact tag in Tookan. Missing tags are created automatically; your other tags are kept.

One master

Products

Choose one catalogue master: HubSpot or Tookan. SKU, name, description, sales price and purchase cost are exchanged.

Your choice

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.

Your choice

Tasks and appointments

Choose either direction or both. Each platform controls the records it creates. Reception settings are explained below.

Map states

Orders and tickets

Choose the direction and master platform, then map states between the two tools.

HubSpot to Tookan

Logged emails

Emails linked to synchronised contacts in HubSpot become Tookan messages, including content and attachment access.

4. Choose contact owners

  1. In Tookan

    Prepare a responsibility type

    The Super Admin creates types under Settings > Contact responsibility types, such as Primary or Reviewer.

  2. 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.

  3. 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.

To send from Tookan to HubSpot
A Tookan state

Choose the workflow and state to send.

A HubSpot stage

Choose the destination pipeline and stage.

Leave Do not synchronise to exclude a state.

To import from HubSpot to Tookan
A HubSpot stage

Choose the stage to import.

A Tookan state

Choose the destination workflow and state.

Unmapped stages are not imported.

By origin

Each platform controls its own records

An order or ticket stays controlled by the platform where it was created.

Tookan is master

Tookan controls all records

Changes in Tookan are copied to HubSpot. Enable both directions for this choice.

HubSpot is master

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

Complete a task
Tookan

The task is archived.

HubSpot

The task is completed.

These states correspond when the relevant sending direction is enabled.

A receiving admin

For tasks

In Company account, the Super Admin selects the default admin. If none is selected, the first active Super Admin receives imported tasks.

A receiving calendar

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

  1. 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.

  2. 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.

  3. 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

  1. 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.

  2. Automatic synchronisation

    Wait after saving

    Exchanges are not instantaneous. You do not need to start any technical operation.

  3. 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.