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
| Topic | Details |
|---|---|
| Who can connect | Admins |
| What you need | A HubSpot account that can approve the app |
| What Gurusup reads | Deals, with their linked contacts, companies, emails, notes, calls, meetings and tasks |
| How changes arrive | When HubSpot reports a change to a deal |
| Past content | Import history, from last week to last year. Without it, only deals that change after you connect come in. |
| Knowledge access | Default 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.
| Part | What Gurusup reads |
|---|---|
| The deal | Name, pipeline and stage, amount, close date, owner, created date and last modified date |
| Linked contacts | First and last name, email, phone, company, job title and dates |
| Linked companies | Name, domain, industry, phone and dates |
| Activity | Emails (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
| Change | What Gurusup does |
|---|---|
| HubSpot reports an event for a deal | Reads the deal again, with its contacts, companies and activity |
| A contact, company, note or email changes on its own | Nothing yet. It comes in the next time the deal is read. |
| A deal changes several times in a short time | Merges the changes into one read |
| A deal is deleted | Withdraws 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 access | Who reads it in Brain |
|---|---|
| Default access | Everyone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them. |
| Restricted | Only the people you pick. Administrators are not included unless you pick them. |
| Private | Only 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
| Message | What 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.