Connect HubSpot

Updated Nov 20, 202614 min read
English
On this page

Connect your HubSpot account, and your team sees each customer's HubSpot contact, company, open deals and open HubSpot tickets next to the conversation. Deskwoot links the people who write to you to their HubSpot contacts, adds the ones HubSpot does not have yet, and writes each resolved conversation to the contact as one note. Once the Deskwoot card is added in HubSpot, HubSpot users who are members of your workspace see the customer's Deskwoot conversations on HubSpot contact and company records.

Each Deskwoot workspace connects one HubSpot account, and a HubSpot account belongs to one Deskwoot workspace. Every Deskwoot plan can connect HubSpot.

Who can connect

  • In Deskwoot, an administrator connects HubSpot, because Deskwoot then writes to HubSpot by itself. A teammate with the permission Manage integrations can reconnect an existing connection or disconnect it.
  • In HubSpot, a Super Admin or a user with App Marketplace access allows Deskwoot.

Connect HubSpot

  1. Go to Settings > Integrations and click the HubSpot card under CRM and real estate.
  2. Click Connect HubSpot.
  3. Sign in to HubSpot and choose the HubSpot account this workspace uses.
  4. Allow Deskwoot.
  5. If HubSpot says the app is not verified, type the confirmation phrase HubSpot shows on that page and confirm. HubSpot asks for this while Deskwoot's app is not yet listed in the HubSpot App Marketplace.

HubSpot then sends you back to the HubSpot page in Deskwoot, which shows Connected. There is nothing to import: Deskwoot reads HubSpot live and starts with the people who write to you after you connect. If you cancel in HubSpot, HubSpot opens its home page. Come back to the HubSpot page in Deskwoot and click Connect HubSpot again. Deskwoot never sees your HubSpot password.

What Deskwoot reads and writes

HubSpot asks you to let Deskwoot read contacts, companies, deals, tickets and owners, and to create contacts, notes, tasks and tickets. Of these, Deskwoot writes contacts, notes and tasks:

  • Contacts: the people HubSpot does not have yet, when Add new customers to HubSpot is on or your team clicks Add to HubSpot. Deskwoot never changes the fields of a contact HubSpot already has.
  • Notes: one note per resolved conversation, and the notes your team adds.
  • Tasks: the tasks your team adds.

Deskwoot keeps no copy of your HubSpot records. It stores which HubSpot contact belongs to which of your contacts, the HubSpot account's name, the email address of the person who connected it, and a short record of each write for 90 days.

The HubSpot section in a conversation

In a conversation, the Details tab has a HubSpot section. The contact page has the same section under Connected systems, with everything Deskwoot sent for the contact. For a linked HubSpot contact it shows:

  • the contact's name with Open in HubSpot;
  • Email, Lifecycle stage, Lead status, Owner (Not assigned yet when nobody owns the contact), Job title, Company and Company owner (only when it is not the contact's owner);
  • up to 3 open deals of the contact and of its primary company, with their stage, amount and close date;
  • up to 3 open HubSpot tickets, the newest first.

Stages show HubSpot's own labels, and amounts keep HubSpot's currency. When no contact is linked, Deskwoot suggests the HubSpot contact with the same email address, else the same phone number. Your team can Link it, choose Not this contact, or use Find contact to search HubSpot by name, email or phone. Linking or unlinking changes nothing in HubSpot. When HubSpot merged the linked contact into another one, the section offers Link the merged record. Your team sees the section only for contacts whose conversations they can open.

In a conversation, your team also adds to HubSpot from the section:

  • Add a note: the text, a link to the conversation and a reference, on the linked contact.
  • Add a task: a HubSpot task on the linked contact, due when your teammate says, owned by the HubSpot user with your teammate's confirmed email address.
  • Add to HubSpot, while no contact is linked: Deskwoot links the HubSpot contact with the customer's email address, or adds a new contact when there is none. This needs the permission Create clients, patients and contacts in connected systems.

When the link is proven (a teammate linked the contact, kept the link or added the contact, the customer verified their email address, or the customer wrote to you from an email address the HubSpot contact holds), notes and tasks also go on the contact's primary company.

New customers

Every 5 minutes, Deskwoot looks up the people who wrote to you in HubSpot by their email address and links the HubSpot contact it finds. The New customers card on the HubSpot page decides what happens:

  • Add new customers to HubSpot, on by default: people HubSpot does not have yet become HubSpot contacts, at most 200 a day. A new contact gets their name, email address, phone number and company, and the HubSpot owner with the confirmed email address of the teammate assigned to the conversation. When the HubSpot setting to create and associate companies is on, HubSpot makes a company from the email domain by itself; Deskwoot never creates one.
  • Inboxes to look up in HubSpot: without a choice, every inbox except email inboxes, also inboxes you add later. Email inboxes are left out because they also get newsletters and vendor mail.
  • Legal basis for new contacts: see the next section.

Deskwoot takes only people with an email address who wrote in the conversation themselves. It leaves out blocked contacts, spam, group chats, Discord conversations and Microsoft Teams channel threads. When a linked contact is deleted in HubSpot, Deskwoot never adds that person again by itself while HubSpot stays connected; your team can still add them with Add to HubSpot. When the 200 a day are reached, the connection card says so, and the people who write meanwhile are added only if they write again later.

Turning a switch on, choosing more inboxes and choosing a legal basis need an administrator. A teammate who manages integrations can turn things off and choose fewer inboxes.

Matched by email, not verified

A contact Deskwoot found in HubSpot by email address shows Matched by an email given in chat, not verified until a teammate clicks Keep link, or picks the right contact with Change contact. Until then the conversation note goes only on the contact, never on its company or deal, and Copilot is told to share no HubSpot details with the customer. If the match is wrong, click Change contact and choose the right HubSpot contact.

A HubSpot account with HubSpot's data privacy settings turned on (its GDPR setting) refuses a new contact without a legal basis for processing it. Deskwoot learns that the setting is on from HubSpot's first refusal. Your workspace decides the legal basis, so Deskwoot never chooses one for you. The choices are HubSpot's own:

  • None (the default): Deskwoot sends no legal basis.
  • Legitimate interest: prospect or lead
  • Legitimate interest: existing customer
  • Legitimate interest: other
  • Performance of a contract
  • Freely given consent from the contact
  • Not applicable

When HubSpot refuses a new contact for want of a legal basis:

  • Recent problems on the HubSpot page shows that one contact with the reason.
  • The New customers card says next to Legal basis for new contacts that your HubSpot account asks for one.
  • Until an administrator chooses one, Deskwoot adds nobody to HubSpot automatically. It still links the people HubSpot already has. It skips the contacts that were already on their way and the new people who write meanwhile, so they do not pile up as problems; the contact page shows why.

Once you choose a legal basis, Deskwoot sends it with every contact it adds. New people are added again, and so are the people it skipped in the last 7 days, the oldest first, as far as the 200 a day allow. Your team can add the contact HubSpot refused, and anyone Deskwoot does not bring back, with Add to HubSpot.

One note per conversation

The Conversation log card decides which conversations go to HubSpot. With Log conversations in HubSpot on (the default) and in the chosen Inboxes to log (without a choice, every inbox), a resolved conversation in which the customer wrote goes to the linked HubSpot contact as one note. When the conversation is resolved again after new messages, Deskwoot updates that same note instead of adding another. Deskwoot keeps its record of each write for 90 days: when the conversation is resolved again more than 90 days after it was last logged, or the note was deleted in HubSpot, it adds a new note.

The note is written in your workspace's language and time zone. It says whether the customer was verified, names the conversation's number and inbox, holds the messages the customer saw (never internal notes) with card numbers that pass the Luhn check, valid IBANs and US Social Security numbers written as 123-45-6789 taken out (other numbers, such as ID card numbers, stay in), and ends with a link to the conversation that only your team can open. Under a proven link the note also goes on the contact's primary company and, when exactly 1 of the contact's own deals is open, on that deal.

  • Every note and task Deskwoot writes carries one reference that starts with Ref dw-. Search HubSpot for it to find Deskwoot's entries, for example to answer a person's request about their data.
  • When a contact is linked only after the conversation was resolved, Deskwoot logs conversations resolved in the last 7 days.
  • Deskwoot logs no group chats, Discord conversations or Microsoft Teams channel threads, no conversation in which the customer never wrote (such as a campaign nobody answered), and no ticket into which a merge brought another contact's messages.
  • Deskwoot writes the conversation notes and the new contacts it adds by itself at most 2 a minute to one HubSpot account. After you resolve hundreds of conversations at once, the notes arrive over a few hours.

The Deskwoot card in HubSpot

The app card Deskwoot shows the customer's Deskwoot conversations on HubSpot contact and company records: the newest 10 and how many there are, each with its number, status, channel, last activity, assignee and a link into Deskwoot. It never shows message text. A company record lists the conversations of the company's contacts, up to the first 100 contacts.

  • The card lists only HubSpot contacts linked to a Deskwoot contact. A contact that merely has the same email address shows nothing.
  • A HubSpot user sees the list only if their HubSpot email address is the confirmed email address of a member of your workspace, and only the conversations that member can open in Deskwoot, within your plan's history window.
  • To add the card, a Super Admin or a HubSpot user who may customize record layouts adds the app card Deskwoot to the right sidebar of contact and company records in HubSpot's record customization settings.
  • The switch Show conversations in HubSpot on the card Deskwoot card in HubSpot is on by default. In a workspace that requires 2FA or single sign on it stays off until an administrator turns it on. Once it is on, signing in to HubSpot is enough for members who have 2FA; members without 2FA and members who must use single sign on see a note to open Deskwoot instead.

AI and privacy

  • When a teammate asks Copilot about a customer, Copilot reads the linked contact's lifecycle stage, lead status, owners, job title, company, open deals and open HubSpot tickets, never an email address or a phone number. It reads only a linked contact, never one that merely matches.
  • This data reaches Deskwoot's AI provider Anthropic only to write the answer. No HubSpot data trains an AI model.
  • Fynn, the AI agent that answers your customers, does not read HubSpot data.
  • Deskwoot stores the HubSpot access encrypted in its database in the EU. HubSpot keeps your data in the data center you chose for your HubSpot account.
  • When a person's data is erased in Deskwoot, the link to their HubSpot contact and the records of what was sent for them are deleted too. You delete the contact in HubSpot yourself.

Disconnect

Disconnect HubSpot at the end of the HubSpot page ends the connection. Deskwoot deletes its access, the links between your contacts and HubSpot contacts, and the HubSpot IDs, record names and error messages it kept of what it sent there. Notes and new contacts that still wait are not sent. Deskwoot also removes its app from your HubSpot account, and HubSpot emails your HubSpot admins about it. Everything already in HubSpot stays there.

If HubSpot does not confirm that the app was removed, Deskwoot says so: remove it in HubSpot under Settings, Integrations, Connected apps. Deleting your Deskwoot workspace disconnects HubSpot the same way first. Deskwoot's audit log keeps a record of each connection, which stays after a disconnect.

Troubleshooting

  • HubSpot did not grant every permission Deskwoot needs. Connect again and allow all of them.
  • Permissions missing on the HubSpot page: HubSpot no longer grants every permission Deskwoot needs. Click Reconnect and allow all of them.
  • Needs a new sign in: HubSpot no longer accepts Deskwoot's access, for example because someone removed Deskwoot in HubSpot. Administrators get an email. Click Reconnect within 30 days of the date the page shows. Until then Deskwoot cannot read or write HubSpot; after 30 days it removes the connection and the links between your contacts and HubSpot contacts, as a disconnect does.
  • This HubSpot account is already connected to another Deskwoot workspace. Disconnect it in that workspace first.
  • HubSpot connected Deskwoot for your HubSpot user only, not for the whole account. Write to hello@deskwoot.com so we can fix it.
  • HubSpot does not let you install Deskwoot. Until HubSpot lists Deskwoot in its App Marketplace, HubSpot allows Deskwoot's app in at most 25 HubSpot accounts. If HubSpot refuses the install, write to hello@deskwoot.com.

Recent problems on the HubSpot page lists the newest 10 things that could not be sent in the last 7 days:

  • This needs a linked HubSpot contact: notes and tasks go to a linked contact. Link one. For a note or task your team added, then click Try again on its line in the conversation; a conversation note follows by itself when the conversation was resolved in the last 7 days.
  • The linked HubSpot contact no longer exists: it was deleted in HubSpot. Link another one. For a note or task your team added, then click Try again on its line in the conversation; a conversation note follows by itself when the conversation was resolved in the last 7 days.
  • HubSpot does not let Deskwoot see this contact: nothing was written. Add the note or task in HubSpot yourself.
  • HubSpot did not accept this: HubSpot's own reason follows.
  • HubSpot already has a contact with this email address, and your team said it is not this person: link the right HubSpot contact with Find contact.
  • Your HubSpot account asks for a legal basis: choose one under New customers (see Legal basis for new contacts).
  • HubSpot is no longer connected: reconnect HubSpot so Deskwoot writes there again.

Frequently asked questions

Does Deskwoot import my HubSpot contacts?

No. Deskwoot reads a contact live while your team looks at it and keeps no copy of your HubSpot records. It stores which HubSpot contact belongs to which of your contacts, the HubSpot account's name, the email address of the person who connected it, and a short record of each write for 90 days. New customers starts with the people who write to you after you connect.

Does Deskwoot change contacts in HubSpot?

No. It adds new contacts, notes and tasks, and updates only its own conversation notes. It never changes the fields of a contact HubSpot already has.

Can I stop Deskwoot from adding people to HubSpot?

Yes. Turn off Add new customers to HubSpot on the New customers card. Deskwoot then still links the people HubSpot already has, and contacts that were waiting to be added are not sent.

Why do email inboxes not add new customers by default?

Email inboxes also get newsletters and mail from vendors, which would become HubSpot contacts. Choose them under Inboxes to look up in HubSpot if they only get customer mail.

Can I connect 2 HubSpot accounts to one workspace?

No. Each workspace connects one HubSpot account, and each HubSpot account belongs to one workspace.

Was this guide helpful?

Keep reading

Ask Fynn about this guide

Get a short answer from this guide and the rest of the help center.

Still need help?

Fynn answers from these guides in the chat, and you can reach the team there too.