> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platinur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Sync HubSpot contacts, companies, and deals from a private app.

## 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](https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview)
and [API usage limits](https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines).