Install Tunnus, step by step
Four steps, about five minutes. The setup page shows where you are and moves on by itself.
Before you start
- A HubSpot account, any edition.
- A user who is Super Admin, or who has the Marketplace access permission.
- Rights to edit the company record layout, for step 3.
1. Connect HubSpot
Click Install. HubSpot asks which account to use and shows the access Tunnus requests. Click Connect app. You come back to the setup page.
Tunnus asks to read and update companies, and to read and create company properties. The security page explains each access in plain words.
2. Create the properties
The setup page reads how many custom properties your HubSpot plan still allows, then lists what it will add: 44 properties, or a compact set of 6 on plans with little room, such as the free plan. Click Create the properties. It takes about fifteen seconds.
- A property that already exists with the same name and type is kept as it is.
- If a property with the same name exists with another type, the step stops and names it. Rename or delete that property in HubSpot, then try again.
3. Add the card to the company record
- Open any company in HubSpot.
- Click Customize at the top of the record and choose the view to edit.
- In the middle column, click the plus sign, open the Card library and filter on Apps.
- Add Tunnus, place it near the top, and save.
The step completes the first time the card opens on a company.
4. Link a first company
Open a Belgian company. The card searches the registry on the company name and shows how many enterprises it found. It also records the match status on the company, so lists can use it.
- Click Show results. If the list is empty, search on the official name, the enterprise or VAT number, or a postal code.
- Click Select on the right enterprise and check its details.
- Click Confirm company. The data is saved and the record shows it right away.
Add a new company
For a company that is not in HubSpot yet, open the Tunnus page: in HubSpot, click the Marketplace icon in the top bar and choose Tunnus (or go to app.hubspot.com/app/your-account-ID/62293246).
- Search on the name, the enterprise number or the VAT number.
- A company already in HubSpot shows an Open link instead of Select, so you go to that record rather than create a second one.
- Select the right enterprise, check it, and click Create company. The new record gets its official name, the registry properties, and the registered address and contact details. No owner is set, so your own assignment rules apply.
Day to day
- Refresh registry data on a linked company fetches the latest data again.
- Link a different company in the full profile replaces a wrong match.
- Build a list on BCE/KBO match status to find companies that still need a check.
If something goes wrong
The card says the account has not finished installing
Open the setup page and finish the open step.
The card says the properties are missing
Step 2 did not run or was undone. Open the setup page and create the properties.
Today's limit is reached
Each HubSpot account can make 300 registry requests a day during the pilot. Opening a company that is not linked yet runs one or two automatic searches; a typed search, a confirm, a create and a refresh count one each. Viewing a linked company does not count. The counter resets at midnight UTC.
No company is found
Try the official name without the legal form, the enterprise or VAT number, or the postal code alone.
Still stuck? Write to andrea@sisurevops.com.