Integrations

HubSpot

Connect HubSpot to see which companies are already in your CRM, give each one a CRM status, filter searches by it, and send companies to HubSpot with the hiring signals behind them.

Connect HubSpot once and JobsPipe keeps a copy of your HubSpot companies. Every company gets a CRM status, searches can include or leave out companies by status, and you can send companies to HubSpot from JobsPipe. The integration is free: connecting, syncing, the CRM list and sending use no credits.

Connect

A workspace owner or admin connects HubSpot in Settings > Integrations with a HubSpot private app token or service key. One HubSpot account per workspace. The token needs these scopes:

  • crm.objects.companies.read and crm.schemas.companies.read, to read your companies and their properties
  • crm.objects.owners.read, to show company owners (without it the CRM list has no owner names)
  • crm.objects.companies.write and crm.schemas.companies.write, to send companies

Connecting another HubSpot account, or removing the connection, deletes JobsPipe's copy of the previous one.

JobsPipe reads your companies, their properties and your HubSpot users (to show company owners). It never reads contacts, emails, notes or deals. It writes to HubSpot only when someone sends companies.

Sync

  • When you connect: every company. A HubSpot account with 20,000 companies takes a few minutes.
  • Every hour: the companies that changed.
  • Every night: every company again, which also picks up companies deleted or merged in HubSpot.
  • Sync now: a full read, from Settings > Integrations.

A change in HubSpot can take up to an hour to show in JobsPipe. A sync that fails keeps the data from the last one and is tried again on the next hour.

How companies are matched

A HubSpot company matches a JobsPipe company by its domain, then its additional domains, then its website. When several JobsPipe companies share a domain, the HubSpot company's LinkedIn company page decides. A company that is not matched shows why in the CRM list:

ReasonWhat it means
No domainThe HubSpot company has no domain, additional domain or website.
Invalid domainWhat is there is not a domain.
Shared domainThe domain is a link page, a URL shortener or a site builder that hosts many companies' sites.
AmbiguousSeveral JobsPipe companies use the domain and the LinkedIn page does not settle it. The CRM list shows the candidates.
Not in JobsPipeJobsPipe has no company on that domain yet.

CRM statuses

Each company has one CRM status. The defaults for HubSpot:

StatusRule
CustomerLifecycle stage is Customer or Evangelist
Open dealNumber of open deals is more than 0
Former customerNo rule until you add one
In CRMAny other company HubSpot has
No CRM matchA company HubSpot does not have

Owners and admins edit statuses in Settings > Integrations > Edit statuses: up to 20 statuses, each with up to 10 conditions on any company property (is any of, is none of, is greater than, is less than, is yes, has any value, is empty), matched all or any. Statuses are checked top to bottom and the first that matches wins. A missing value never matches a condition, except "is none of" and "is empty". Preview shows how many companies each status would have before you save. Saving reads every company again.

Filter searches by CRM status

Job search and company search take crm_status_or and crm_status_not, with the status keys (customer, open_deal, former_customer, your own statuses, in_crm, no_crm_match):

{
  "job_title_or": ["Data Engineer"],
  "job_country_code_or": ["US"],
  "crm_status_not": ["customer", "open_deal"]
}

finds data engineering jobs at companies that are not customers and have no open deal. "crm_status_or": ["no_crm_match"] finds jobs at companies your CRM does not have at all. With no CRM connected, every company is no_crm_match. See filters.

The CRM status filters work in job search, company search and exports. Signals and data feeds do not take them yet and answer 400 when they are set. One search can filter by up to 30,000 CRM companies: when the statuses you pick cover more, use the opposite filter (crm_status_not instead of crm_status_or, or the other way round).

Send companies to HubSpot

Send one company from its page, or up to 1,000 at once from a list or a search. Before anything is written you see how many will be created, how many are already in HubSpot and will be updated, and how many cannot be sent and why. You can send a company you have revealed: one in any of your lists, or one your CRM already has.

What a send writes, by default:

  • Company name and domain: on new companies. Never changed on companies HubSpot already has.
  • Website and LinkedIn page: filled only when empty.
  • JobsPipe properties, in a "JobsPipe" property group, updated on every send: open job postings, the signals timeline (why the company is worth a look and the job ads behind it, with a link to the company in JobsPipe), the JobsPipe profile link and the JobsPipe company ID.

Before a company is created, HubSpot is checked again by domain and by JobsPipe company ID, so a company someone added since the last sync is updated rather than duplicated. New companies are owned by the person who sent them when that person is a HubSpot user.

Owners and admins choose what a send writes in Settings > Integrations > Edit settings:

  1. How to send: create and update companies, create new companies only, or update existing companies only.
  2. Map fields: send employees, industry, country, city, founded year or description to a HubSpot property, and for each one keep the HubSpot value or replace it. An empty HubSpot value always takes JobsPipe's. Industries are matched to the options of HubSpot's industry property, and one with no matching option is left out.
  3. New companies: fixed values for companies a send creates, such as a lifecycle stage or a lead source.
  4. Review: a few companies field by field, before and after. Nothing is written until a send.

Every send is listed with who sent it and how many companies were created, updated, skipped or failed, with what HubSpot did with each company.

Disconnect

Settings > Integrations > Disconnect HubSpot stops syncing and deletes JobsPipe's copy of your companies. Companies JobsPipe created or updated in HubSpot stay there. After disconnecting, every company is no_crm_match.

On this page