Sign in to SourceMedium, open your store, then choose Data sources → Connect data source and select the platform. You need an Admin or Editor workspace role.After you connect explains the first sync and connection statuses.
Vendor documentation
Requirements
- A HubSpot service key with four read scopes:
crm.objects.contacts.read,crm.objects.companies.read,crm.objects.deals.readandcrm.objects.owners.read. SourceMedium does not need write scopes. - Super Admins and users with the Developer tools access permission can create service keys in HubSpot.
- HubSpot no longer lets you create new legacy private apps. If you already have a private app token (it also starts with
pat-) with the same scopes, you can use it instead of a service key.
How to connect
1
Create a service key in HubSpot
In HubSpot, go to Development, then Keys → Service keys in the left sidebar, and click Create service key. Click Add new scope, select the four read scopes listed above, and click Update.
2
Copy the key
Open the key, click Show, then Copy.
3
Add the key in SourceMedium
Find HubSpot in the connector picker and click Connect. Paste the key and click Connect.
4
Confirm it is connected
SourceMedium reads one record each of contacts, companies, deals and owners before saving the key. A key HubSpot rejects as invalid is not saved. If the key is missing a scope, SourceMedium still saves the connection and names the missing scope: add it to the key in HubSpot, then save the key again. The connection reads Awaiting first data until the first sync lands, then Connected.
SourceMedium only ever reads from your connected platforms. It does not create, change, or delete anything, so create the key with read-only access wherever the platform offers it. Treat it like a password: keep it confidential and avoid sharing it over email or in spreadsheets. If the credential is rotated or revoked, follow this guide’s connection method to update SourceMedium.
What data syncs
Contacts, companies, deals and owners.Notes
- HubSpot is listed under Email & SMS. CRM deal pipeline reporting is not the product surface for this connector.

