Help

Connect HubSpot

Keep working in HubSpot and let MedaRep fill it in. The surgeons you sell to arrive as contacts with their practice as the company, and every visit, call, follow-up and status change you log in MedaRep lands on their timeline within seconds.

Before you start

  • A paid MedaRep plan (from $39 a month). See plans.
  • A HubSpot account. The free HubSpot CRM works; no paid HubSpot hub is needed.
  • You are a Super Admin of that HubSpot account, or have App Marketplace access. If you are not, ask whoever is to connect it, or to give you access.

Connect

  1. In MedaRep, open Settings and find HubSpot.
  2. Choose Connect HubSpot, sign in to HubSpot and pick the account to connect.

    HubSpot lists every account your login can reach. Pick the one you keep your accounts in.

  3. Review what MedaRep may do and choose Connect app.

    Until HubSpot has reviewed MedaRep for its App Marketplace, it marks the app as unverified and asks you to confirm before connecting. The permissions it lists are the ones in the table below, and nothing more.

  4. Back in MedaRep, the card shows the account you connected.

    The first sync sends every customer you have marked, your visits and calls from the last 180 days, and your open follow-ups. After that, each change goes across within a few seconds.

What goes to HubSpot

In MedaRepIn HubSpot
A surgeon you mark as a customerA contact: name, specialty as the job title, practice address, and MedaRep fields (NPI, profile link, practice, customer since, where the account stands, last visit) in a MedaRep property group
Their practiceA company, with the contact associated to it
A case, meeting, in-service or meal you logA completed meeting on the contact, with your note
A call you logA completed outbound call, with your note
A follow-upA task due that day, assigned to you; finishing it in MedaRep completes it
A change in where an account standsA note on the contact, and the status field updated
Unmarking a customerThe contact stays; its MedaRep customer field turns to No

Contacts are matched on the surgeon’s NPI, so syncing again never makes a duplicate. MedaRep keeps the fields it sends up to date; your own fields, deals, emails and other activities are never touched.

What never goes

  • Case volumes, estimates, forecasts and industry payments. They stay in MedaRep.
  • Patient information. MedaRep refuses a note that looks like it holds any before it is saved, so it can never reach HubSpot.
  • One thing comes back from HubSpot: a follow-up’s task you complete there closes the follow-up in MedaRep at the next sync. Nothing else is read back.

On a team

Each rep connects their own HubSpot login. If your team shares customers in MedaRep, a teammate’s visits reach your HubSpot too, marked with their name and left unassigned. Two teammates connected to the same HubSpot account create each record once.

Sync now, disconnect, delete

  • Sync now sends everything again. Records already there are updated, not duplicated.
  • Disconnect stops the sync and revokes MedaRep’s access at HubSpot. What is already in HubSpot stays there.
  • Deleting your MedaRep account disconnects HubSpot the same way.
  • You can also remove MedaRep from HubSpot under Settings, Integrations, Connected apps; MedaRep’s card then asks you to connect again.

The permissions MedaRep asks for, and why

HubSpot permissionWhat MedaRep does with it
crm.objects.contacts.write / .readCreates and updates the contacts for your customers, finds them by NPI, and adds meetings, calls, tasks and notes to them.
crm.objects.companies.write / .readCreates and updates each practice as a company, finds it by its PECOS group ID, and associates the contact.
crm.schemas.contacts.writeCreates the MedaRep contact fields once (NPI, profile link, practice, customer, customer since, status, last visit).
crm.schemas.companies.writeCreates the MedaRep company fields once (PECOS group ID, practice page link).
crm.objects.owners.readFinds your HubSpot user, so the tasks and activities are assigned to you.
oauthRequired of every HubSpot app: names the account you connected, shown on MedaRep’s card.

Access tokens are encrypted before they are stored and never shown on any page or export. See the privacy policy for how MedaRep handles your data.

If something goes wrong

  • HubSpot says you cannot install apps. Only a Super Admin, or a user with App Marketplace access, can connect one.
  • The card says to connect again. MedaRep’s access was removed in HubSpot or expired. Connect again; nothing is lost.
  • Something is waiting or could not be sent. The card lists it with the reason. MedaRep retries on its own over the next day; Sync now tries again at once.
  • There is no Connect button. HubSpot sync comes with a paid plan; on Free the card says so.

Still stuck? Write to spd@medarep.com with the HubSpot account name.

NextCompliance and your dataWhat MedaRep holds, what you and your AI assistant can write, what is logged, and what is refused.