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
- In MedaRep, open Settings and find HubSpot.
- 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.
- 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.
- 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 MedaRep | In HubSpot |
|---|---|
| A surgeon you mark as a customer | A 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 practice | A company, with the contact associated to it |
| A case, meeting, in-service or meal you log | A completed meeting on the contact, with your note |
| A call you log | A completed outbound call, with your note |
| A follow-up | A task due that day, assigned to you; finishing it in MedaRep completes it |
| A change in where an account stands | A note on the contact, and the status field updated |
| Unmarking a customer | The 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 permission | What MedaRep does with it |
|---|---|
| crm.objects.contacts.write / .read | Creates and updates the contacts for your customers, finds them by NPI, and adds meetings, calls, tasks and notes to them. |
| crm.objects.companies.write / .read | Creates and updates each practice as a company, finds it by its PECOS group ID, and associates the contact. |
| crm.schemas.contacts.write | Creates the MedaRep contact fields once (NPI, profile link, practice, customer, customer since, status, last visit). |
| crm.schemas.companies.write | Creates the MedaRep company fields once (PECOS group ID, practice page link). |
| crm.objects.owners.read | Finds your HubSpot user, so the tasks and activities are assigned to you. |
| oauth | Required 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.