HubSpot destination
HubSpot destination
A HubSpot destination sends Outrun people to HubSpot contacts and Outrun organisations to HubSpot companies. This page covers setup, permissions and how records are matched in HubSpot.
Connect HubSpot
- In Outrun, go to Destinations and select Add Destination.
- On the HubSpot card, select Connect.
- In 1. Select HubSpot Account, select Add HubSpot Account and approve access in HubSpot. Then select the account and select Continue.
- In 2. Configure Destination, enter a Destination Name (the default is
HubSpot CRM). Optionally open Advanced Settings to clear Enable People Mapping or Enable Organization Mapping. Both are selected by default. Select Continue. - In 3. Review & Confirm, select Create Destination.
Permissions
Outrun connects with HubSpot OAuth. A destination account needs these scopes:
| Scope | Why |
|---|---|
crm.objects.contacts.write |
Write contacts |
crm.objects.companies.write |
Write companies |
tickets |
Required for every HubSpot connection |
crm.schemas.deals.read |
Required for every HubSpot connection |
e-commerce |
Required for every HubSpot connection |
oauth |
Required for every HubSpot connection |
crm.schemas.contacts.read |
Required for every HubSpot connection |
crm.schemas.companies.read |
Required for every HubSpot connection |
HubSpot shows the two write scopes as optional on the consent screen. Approve them. If a connected account is missing any of these scopes, the account list flags it and shows Reauthorise. Select Reauthorise to grant them.
What is sent
Outrun sends people and organisations when records from your sources are created or change. See when records are sent for the full rules.
- People go to HubSpot contacts. Outrun sends the email address and other contact details. If HubSpot already has a contact with the same email address, Outrun updates that contact instead of creating a second one.
- Organisations go to HubSpot companies. Outrun sends the company name and domain. If HubSpot has a company with exactly the same domain, Outrun updates it. Otherwise it creates a new company.
- After the first send, Outrun updates the same HubSpot contact or company each time the record changes.
