Skip to main content

HubSpot CRM Integration

How to connect HeyDrop Teams to HubSpot, choose what syncs, and disconnect or uninstall the HeyDrop Contacts Integration app.

The HeyDrop Contacts Integration app sends the contacts your team collects with HeyDrop digital business cards to HubSpot, where they appear as HubSpot contacts. Your team keeps sharing cards and scanning business cards as usual, and the contacts show up in HubSpot automatically.

How the sync works

  • Direction: one way, from HeyDrop to HubSpot. HeyDrop never deletes HubSpot contacts and never overwrites values that are already in HubSpot.

  • Which contacts: every contact your team collects in HeyDrop, for example through the contact exchange form on a card or with the AI Scanner.

  • Matching: contacts are matched by email address. If a contact with the same email already exists in HubSpot, HeyDrop doesn't create a duplicate.

  • Fields: email, first name, last name, job title, company and phone.

  • Timing: automatic. New contacts usually appear in HubSpot within 2 minutes.

  • Contacts collected before you connected: send them once with Sync existing contacts (see Settings below).

Before you start

  • In HeyDrop: a HeyDrop Teams account and admin access to your team in the HeyDrop Teams web panel at app.heydrop.me.

  • In HubSpot: a user who is a Super Admin or has App Marketplace access permissions. The integration works with any HubSpot plan, including the free HubSpot CRM.

Permissions the app requests

When you connect, HubSpot asks you to approve three permissions:

What HubSpot shows

Scope

Why HeyDrop needs it

View properties and other details about contacts

crm.objects.contacts.read

To check whether a contact with the same email already exists and which of its fields are empty, so HeyDrop doesn't create duplicates or overwrite your data.

Create, delete, or make changes to contacts

crm.objects.contacts.write

To create new contacts and fill in empty fields. This is HubSpot's standard contact permission. HeyDrop never deletes contacts.

View properties about the installing account including primary domain and user emails

oauth

Required for every app that connects with OAuth. HeyDrop uses it to identify the connected HubSpot account and show its account ID.

Connect HubSpot

Step 1: Open the HubSpot integration

Sign in to HeyDrop Teams at app.heydrop.me. In the left sidebar, click Integrations, then click Manage on the HubSpot card.

Step 2: Click Connect

Click Connect. HubSpot opens in a new browser tab. If you're not signed in to HubSpot, sign in first.

Step 3: Choose your HubSpot account

Select the HubSpot account you want to connect and click Choose Account.

Step 4: Approve the permissions

Review what HeyDrop Contacts Integration can access (see Permissions the app requests above) and click Connect app.

Step 5: You're connected

You're taken back to HeyDrop Teams. The status changes to Active, the page shows the ID of the connected HubSpot account, and new contacts start syncing right away.

Settings

All settings are on the HubSpot page in Integrations. Changes are saved as soon as you make them.

Activate HubSpot integration

Turn the switch off to pause syncing without disconnecting HubSpot. Turn it back on to resume.

When to sync contacts

Choose how HeyDrop treats contacts that already exist in HubSpot:

  • New contacts only (default): new HeyDrop contacts are created in HubSpot. If a contact with the same email already exists in HubSpot, it's left untouched. Later edits in HeyDrop aren't synced.

  • New and updated contacts: new contacts are created in HubSpot. When a contact already exists in HubSpot, or is edited in HeyDrop later, HeyDrop only fills in fields that are empty in HubSpot (first name, last name, job title, company and phone). Values already in HubSpot are never overwritten. Changes can take up to 2 minutes to appear.

Sync existing contacts

Click Sync existing contacts to send all contacts your team collected before you connected HubSpot. Missing contacts are created in HubSpot. With New and updated contacts selected, contacts that already exist in HubSpot also get their empty fields filled in. The sync runs in the background, so you can leave the page.

Using the integration

Once the status is Active, there's nothing else to do. Every new contact your team collects in HeyDrop appears in your HubSpot contacts, usually within 2 minutes.

Disconnect HubSpot in HeyDrop

  1. In HeyDrop Teams, go to Integrations and click Manage on the HubSpot card.

  2. Click Delete Integration at the bottom of the page.

  3. Click Delete to confirm.

What happens to your data: HeyDrop stops sending contacts to HubSpot right away. Contacts already in HubSpot stay there unchanged, and your team's contacts in HeyDrop aren't affected. The app stays in HubSpot's Connected Apps until you uninstall it there. To use the integration again, follow Connect HubSpot above.

Uninstall the app from HubSpot

  1. In HubSpot, click the settings icon in the top navigation bar.

  2. In the left sidebar, go to Integrations > Connected Apps.

  3. Find HeyDrop Contacts Integration, click Actions and choose Uninstall.

  4. Type uninstall to confirm and click Uninstall.

What happens to your data: HeyDrop loses access to your HubSpot account and can no longer send contacts. Contacts already created in HubSpot are not deleted, they just won't be updated anymore. Your contacts in HeyDrop aren't affected. To remove the connection from HeyDrop as well, click Delete Integration in HeyDrop as described above.

Troubleshooting

  • New contacts don't appear in HubSpot: check that the status is Active and Activate HubSpot integration is on, then allow up to 2 minutes.

  • A field in HubSpot didn't change: this is expected. New contacts only never updates existing HubSpot contacts, and New and updated contacts only fills in empty fields.

  • The wrong HubSpot account is connected: click Delete Integration, then connect again and choose the right account.

  • You uninstalled the app in HubSpot and want to use it again: in HeyDrop, click Delete Integration, then follow Connect HubSpot above.

Need help?

Email us at [email protected] or click Need Help? Let's Chat in the HeyDrop Teams sidebar.

Did this answer your question?