HubSpot Setup Guide
Prerequisites
You can use OAuth or an access token from a private app to authenticate your HubSpot account. If you connect using a private app, you need to configure the appropriate scopes for the following streams:
| Stream | Required Scope |
|---|---|
| company | crm.objects.companies.read, crm.schemas.companies.read |
| contact | crm.objects.contacts.read |
| property | crm.schemas.properties.read |
| feedback submission | crm.objects.feedback_submissions.read |
| custom object | crm.objects.custom.read, crm.schemas.custom.read |
| engagement | sales-email-read |
| marketing_email | content |
| email_event | content |
Note: Custom objects are discovered only when crm.objects.custom.read and crm.schemas.custom.read are granted. If either scope is missing, the connector is still created, but not all custom object streams will appear in the Schema tab. To add them, grant the missing scopes in HubSpot and then re-authenticate through the Manage tab on the asset page in Matia. Your custom objects will be discovered and shown in the Schema tab on the next sync.
Setup Guide
- Either authenticate your account with OAuth or enter the Access Token that you received when creating your private app.
- Enter a Name for the connector.
- (Optional) Enter a Description for the connector.
- Select the Owner of the connector.
- (Optional) Verify that your HubSpot account is successfully connected by clicking on Test Connection.
- Click Connect.
Supported Streams
Two types of incremental sync modes are supported:
- Incremental (standard server-side, where the API returns only the data updated or generated since the last sync)
- Client-Side Incremental (the API returns all available data and the connector filters out new records)
This connector outputs the following streams:
- Company (Full Refresh, Incremental)
- Company Property History (Full Refresh, Incremental)
- Contact (Full Refresh, Incremental)
- Contact Property History (Full Refresh, Incremental)
- Contact Form Submission (Full Refresh, Incremental)
- Property (Full Refresh, Incremental)
- Property Option (Full Refresh, Incremental)
- Team (Full Refresh)
- Role (Full Refresh)
- Users (Full Refresh)
- Email Subscription (Full Refresh)
- Deal Pipeline (Full Refresh, Incremental)
- Owner (Full Refresh, Incremental)
- Deal (Full Refresh, Incremental)
- Email Event (Full Refresh, Incremental)
- Email Subscription Change (Full Refresh, Incremental)
- Custom Object (Full Refresh, Incremental)
- Engagement (Full Refresh, Incremental)