Send leads to HubSpot
Create a service key in HubSpot, paste it into HeyLeads, and send any list as contacts. No duplicates.
HeyLeads creates new contacts in HubSpot, updates the ones you already have, and never makes a duplicate. It also adds a small HeyLeads group of fields to your contacts so you can see where each person came from.
#Connect it
In HeyLeads, open Settings, Integrations, then the HubSpot tile
In HubSpot, open Development, then Keys, then Service Keys
Older accounts that still show Legacy apps can create a Private app there instead. It gives the same kind of token.
Choose Create service key and name it HeyLeads
Choose Add new scope and add three scopes
crm.objects.contacts.read,crm.objects.contacts.writeandcrm.schemas.contacts.write. Search for each, tick it, then choose Update.Choose Create, confirm, press Show and copy the key
It starts with
pat-.Paste it into HubSpot service key (or private app token) in HeyLeads and press Check and connect
HeyLeads asks HubSpot whether the key works before saving anything. A green line such as Connected to HubSpot means you're done. A yellow line names a permission to add.
#Send a list
On the HubSpot tile, find your connection
Under Which HeyLeads list, choose the list
Press Send this list to HubSpot
When it finishes you'll see a sentence like Sent 48 to your contacts in HubSpot. 2 had no email. Open Activity to see this and earlier sends.
#What gets sent
| HeyLeads | HubSpot |
|---|---|
| Email (how HubSpot finds an existing contact) | |
| First name, Last name | First name, Last name |
| Job title | Job title |
| Company | Company name |
| Location | City |
| LinkedIn link | HeyLeads LinkedIn URL |
| The list you sent | HeyLeads list |
- Empty fields are left out, so a blank in HeyLeads never wipes something you already have in HubSpot.
- HeyLeads never changes Lifecycle stage.
- Custom fields and tags are not sent.
- People marked do not contact, and leads with no email, are left out (and counted, not lost).
#When something goes wrong
| What you see | What to do |
|---|---|
| HubSpot rejected that token | Copy the key again in full and paste it. It was cut short or deleted. |
| The HubSpot key is missing a permission | Add the scope named in the message on the key's Scopes tab and connect again. |
| HubSpot would not take some contacts | Open Activity for the reason (often a badly formed email), fix those leads and send again. |
| HubSpot asked us to slow down | Wait a minute and press the button again. |
| Needs a look on the tile | The token no longer works. Connect again with a fresh key. |
| The send button is grey | Pick a list. If the connection says paused, press Resume. |
Is there a size limit?
One send carries at most 5,000 people. For a bigger list HeyLeads sends the first 5,000 and shows a Send the next button to carry on.
Does it sync automatically when someone replies?
Not yet. Today you send a list yourself. Automatic sync is planned.
How do I disconnect?
On the connection card press the bin icon, Disconnect, then confirm. The saved key is deleted. Contacts already sent stay in HubSpot. To fully remove access, also delete the key in HubSpot.