ConnectorsHubSpot

Connect HubSpot

Connect HubSpot, see which deal fields and activity Gurusup reads, bring in deals from before you connected with Import history, and fix errors.

Admins only. Gurusup only reads HubSpot and never changes anything in your account.

At a glance

TopicDetails
Who can connectAdmins
What you needA HubSpot account that can approve the app
What Gurusup readsDeals, with their linked contacts, companies, emails, notes, calls, meetings and tasks
How changes arriveWhen HubSpot reports a change to a deal
Past contentImport history, from last week to last year. Without it, only deals that change after you connect come in.
Knowledge accessDefault access, Restricted or Private. See Who can read it.

Before you start

  • Decide who should read your deals in Gurusup. Restricting later only covers what comes next.
  • The same HubSpot account can be connected to several Gurusup organizations, each approving it on its own. One organization can also connect several HubSpot accounts. See Connectors overview.

Connect HubSpot

Open the HubSpot connector

In the sidebar, open Sources, then Catalog, find HubSpot (use Search sources if you need to) and click Connect on its row. Its page opens. Next to Organization accounts, click Connect for the organization. The dialog Connect HubSpot for the organization opens.

Choose who reads it

Optional. In the dialog, under Who can read it, choose Default access, Restricted or Private from Access mode.

Connect and approve access

In the dialog, click Connect and approve access to your HubSpot account. HubSpot sends you back, and a message says HubSpot is connected.

Bring in earlier deals

Optional. Gurusup learns from the moment you connect and does not import your existing deals by itself. To bring in deals from before, use Import history: see Import past work.

What HubSpot asks you to approve

Read access only: deals, contacts, companies, owners, and the emails logged on your records. Gurusup has no permission to create or change anything in HubSpot.

What Gurusup reads

Gurusup reads deals, not your whole CRM. A deal counts when it changes after you connect, or when you bring it in with Import history. Closed won and closed lost deals count too.

PartWhat Gurusup reads
The dealName, pipeline and stage, amount, close date, owner, created date and last modified date
Linked contactsFirst and last name, email, phone, company, job title and dates
Linked companiesName, domain, industry, phone and dates
ActivityEmails (subject, text, direction and status), notes, calls (title, notes, outcome and duration), meetings (title, notes and outcome) and tasks (subject, notes, status and priority)

Gurusup reads up to 20 items of each kind per deal: 20 emails, 20 notes, 20 contacts, 20 companies, and so on. It takes the first 20 HubSpot returns, which are not always the newest.

What Gurusup does not read

  • Contacts and companies that are not linked to a deal.
  • Anything that is not a deal or attached to one.
  • Archived deals.
  • Deals that last changed before you connected and that you did not import. HubSpot events from before you connected are ignored too.
  • Meetings and tasks dated in the future. A deal's document leaves them out, and they do not take the place of recent ones, until their date has passed and the deal is read again.
  • Activity beyond the 20 items per kind.

How changes arrive

ChangeWhat Gurusup does
HubSpot reports an event for a dealReads the deal again, with its contacts, companies and activity
A contact, company, note or email changes on its ownNothing yet. It comes in the next time the deal is read.
A deal changes several times in a short timeMerges the changes into one read
A deal is deletedWithdraws it. What Gurusup learned only from that deal goes; what other sources also back stays.

Import past work

Gurusup learns from the moment you connect, in setup too. Until you import, History reads "Only new content comes in until you import past content." There is no deal picker: you choose how far back to go.

Open Import history

On Sources, open the HubSpot page. Under History, click Import history. Only admins see it, and the connection has to be working.

Pick how far back

Pick Last week, Last month, Last 3 months, Last 6 months or Last year. The dialog counts the deals, for example "~40 deals" (with a plus sign instead of the tilde when the count is capped), and shows what the import would use out of what you have left this month, in euros. If nothing matches it says "Nothing to import in this window".

Import

Click Import. The message reads "Importing history. It keeps going in the background." When it is done, the row reads "Imported the last" followed by the window and the date.

A deal comes in when it has activity in the window you pick: it was modified, a note on it was updated, or it had sales activity. Archived deals stay out. Each deal becomes one document with its contacts, companies and activity, as described in What Gurusup reads. A longer window later reads only the part you had not imported. Reconnecting the same HubSpot account keeps what you imported.

Imported is not learned yet: follow each deal on Follow ingestion. The button is off if the connection is not active or the organization is in Demo Mode. For what happens when the import costs more than you have left, see Import history.

Who can read it

What Gurusup learns from one HubSpot account is one source, and its access covers every deal.

Knowledge accessWho reads it in Brain
Default accessEveryone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them.
RestrictedOnly the people you pick. Administrators are not included unless you pick them.
PrivateOnly you. Administrators are not included.

To change it later, open the HubSpot page and change Access mode under Knowledge access; it saves as soon as you change it. Restricting later only covers what comes in after that. See Restrict a source to specific people.

Check that it worked

Find the row

On Sources, a HubSpot row is there.

Follow the deals

After you import deals or a deal changes, open Ingest and pick the HubSpot source in the filter. Deals move from Queued to Learning to Learned.

Change a deal

Change a deal's stage in HubSpot. It shows up on Ingest as a new update for the same deal.

Reconnect

If HubSpot stops accepting the connection, for example the app was removed in HubSpot, its status reads Needs reconnect. Click Reconnect on the account's row under Organization accounts and approve again. Until you do, Gurusup reads no new deal changes.

Disconnect

On Sources, open the HubSpot page. Under Danger zone, open the menu on Disconnect, choose Disconnect and confirm. It removes the whole connection to that HubSpot account, not only the source you opened, and Gurusup deletes the credentials it stored for your organization; what Gurusup learned stays. Gurusup does not revoke the approval in HubSpot: to remove the Gurusup app from the HubSpot account, do it in HubSpot, which also cuts off any other organization that connected the same account. A HubSpot source has no Remove source while it is connected. While ingestion is paused or Demo Mode is on, these buttons do not work and Gurusup ignores HubSpot changes. See Remove, disconnect and what stays.

If it does not work

MessageWhat to do
"The import didn't finish. Try again, and contact support if it keeps failing."Click Try again under History. If it keeps failing, contact support.
"We couldn't estimate this. You can still import."The count did not load. You can still click Import.
"This source needs to be reconnected." or "This connection needs to be reconnected."Click Reconnect on the account's row and approve again, then import again.
"We couldn't finish this because of a problem on our side. Your connections and data are safe. Try again in a few minutes, and contact support if it keeps failing."Try again in a few minutes.
"Ingestion is paused for this organization. Ask your organization admin to resume ingestion before adding content." or "Demo Mode prevents changing external sources. Ask your organization admin to turn off Demo Mode to continue."Contact support. See When ingestion is paused or Demo Mode is on.

A deal is missing? Check that it is not archived, that it changed after you connected or falls in a window you imported, and that what you expect is linked to the deal. Failed approvals are covered in Connector troubleshooting.