HubSpot
Connect HubSpot to Linq: new contacts become HubSpot contacts, edits update them. What's shared, how to set it up, disconnect or uninstall.
With the HubSpot integration, every contact you collect with Linq goes straight into HubSpot as a contact. That includes people who share their details from your card and people you add or scan yourself. When you edit them in Linq, the same HubSpot contact is updated. There’s nothing to export or copy by hand.
What you need
- Linq Business. Connected apps are part of Business, for you or for your whole team.
- A HubSpot account, on any HubSpot plan, including free. To connect it, you need to be a Super Admin in HubSpot or have the App Marketplace Access permission.
Connect HubSpot
- In Linq, open Integrations from the app’s menu (or Settings → Integrations) and go to Connected apps.
- Select Connect next to HubSpot.
- Sign in to HubSpot if asked, and choose the HubSpot account to connect.
- Review what Linq asks to do, which is to read and write contacts, then select Connect app.
- You come back to Linq, with HubSpot connected and your HubSpot account’s domain next to it.
- Select Send test. A sample contact, Jane Cooper (Linq test), appears in HubSpot under CRM → Contacts. You can delete it.
From then on, each new contact goes to HubSpot within seconds of being added.
Connect it for your whole team
A team’s owners and admins can connect HubSpot once for everyone, under Team → Integrations. Every contact the team’s cards capture then goes to HubSpot, whoever captured it. That includes contacts from a kiosk and your Business Card.
What’s shared with HubSpot
Linq sends these properties for each contact. Empty fields are left out, so Linq never blanks a property in HubSpot.
| HubSpot property | What Linq puts there |
|---|---|
| First Name, Last Name | Their name. The last word goes in Last Name and the rest in First Name. A single name goes in Last Name. |
| Their email address | |
| Phone Number | Their phone number |
| Company Name | Their company |
| Job Title | Their job title |
| Website URL | Their website or LinkedIn |
Not shared with HubSpot: your private notes, where you met, your tags, their message, their answers to your form’s questions, and their consent record. If you need those in HubSpot, a webhook sends every field, and a HubSpot workflow or Zapier can map them.
What Linq can access in HubSpot
Linq asks HubSpot for permission to read and write contacts (crm.objects.contacts.read and crm.objects.contacts.write). It uses that permission only to add and update the contacts it sends. Linq never reads, imports or deletes anything else in your HubSpot account.
Linq keeps two things from HubSpot: the ID of each HubSpot contact it created or updated, so later edits reach the same contact, and your HubSpot account’s domain, to show which account is connected. Its access to HubSpot is stored encrypted.
How contacts stay in sync
- New contacts. Each new contact on your cards, and each contact assigned to you, goes to HubSpot as soon as it’s added. When you import contacts, tick Also send them to my webhooks and connected apps to send them too.
- No duplicates. If HubSpot already has a contact with the same email address, Linq updates that contact instead of adding another. A contact without an email address is added as a new HubSpot contact.
- Edits. When you change a contact’s details in Linq, the same HubSpot contact is updated. Linq’s values replace what’s in the properties above. A field you clear in Linq stays as it was in HubSpot.
- One way. Changes go from Linq to HubSpot only. Editing or deleting a contact in HubSpot doesn’t change Linq, and deleting a contact in Linq doesn’t delete it from HubSpot.
Disconnect HubSpot
In Linq, open Integrations (or Team → Integrations) and select Disconnect next to HubSpot.
- New contacts stop going to HubSpot straight away.
- Linq deletes its access to your HubSpot account and asks HubSpot to cancel it.
- Your data stays where it is. Contacts already sent stay in HubSpot, and your contacts in Linq are untouched.
- If you connect again later, new contacts go to HubSpot again. Earlier contacts aren’t sent again unless you edit them. Edited contacts are matched by email address, so they aren’t duplicated.
Uninstall Linq from HubSpot
Disconnecting in Linq leaves the Linq app installed in your HubSpot account, because other people in your company may still use it. To remove it completely:
- In HubSpot, select the Settings icon and go to Integrations → Connected Apps.
- Find Linq and choose Uninstall, then confirm.
After you uninstall:
- Every Linq connection to that HubSpot account stops sending contacts and shows Needs sign-in in Linq.
- Contacts already in HubSpot stay there, and your contacts in Linq are untouched.
- To use the integration again, connect HubSpot from Linq. This installs the app again.
If something goes wrong
| What you see in Linq | What it means | What to do |
|---|---|---|
| Delivery failed | HubSpot didn’t take the last contact, for example because HubSpot was busy. | Nothing: Linq tries again after 1 minute, 5 minutes, 30 minutes and 2 hours. If it keeps failing, contact us. |
| Needs sign-in | HubSpot stopped accepting Linq’s access, for example because the app was uninstalled in HubSpot. | Select Sign in again. Contacts added in the meantime aren’t sent. |
| HubSpot won’t let you connect | You aren’t a Super Admin and don’t have App Marketplace Access in HubSpot. | Ask a Super Admin to connect, or to give you that permission. |
| Nothing is sent | Your account, or your team, isn’t on Business any more. | The connection is kept and starts sending again once you’re back on Business. |
Help
Questions about the HubSpot integration: email hello@linq-business.com or see Get help. For how Linq handles the data it sends to connected apps, see our Integrations Data Policy and Privacy Policy.
Last updated
Need more help?
Check the FAQ or troubleshooting, or contact us.