Skip to main content

​
Create the credential

In HubSpot, open Development → Legacy apps → Private apps, create a private app for Platinur, and grant only the read scopes needed for the objects you select: crm.objects.contacts.read, crm.objects.companies.read, and/or crm.objects.deals.read. Save the app and copy the private app access token when HubSpot displays it. Do not add write scopes.

​
Connect

  1. Open Integrations → New Source → HubSpot.
  2. Paste the private app token and choose Contacts, Companies, and/or Deals.
  3. Test the connection and create the source.
  4. Discover the selected objects in Schema, then run the first sync.
  5. Add a schedule if the source should refresh automatically.
Paste the token into Private app access token. Test endpoint verifies that it can read the selected CRM objects. After source creation, use Schema to confirm the selected objects, then run the first Sync. The connector follows HubSpot’s paging.next cursor and requests a reviewed set of useful properties for each object. Rate-limit and provider failures are retried within bounded limits; an incomplete sync is reported as failed.

​
Common failures

  • 401 unauthorized: copy the current private-app token again, without quotes or spaces.
  • 403 missing scope: add the exact read scope for the object being loaded, then test again.
  • An object is missing: select Contacts, Companies, or Deals in Platinur and ensure the app has that object’s corresponding read scope.
  • Rate limit: allow the connector retry to finish; stagger schedules if the error recurs.

​
Rotate or revoke access

Create or rotate the private-app token in HubSpot, paste the new token into the source’s Config tab, and Test endpoint before revoking the previous token. To stop access now, disable or delete the source and revoke the token or delete the private app in HubSpot. See HubSpot’s private app documentation and API usage limits.