HubSpot Connector
Prerequisites
- A HubSpot account (Free, Starter, Professional, or Enterprise)
- Super Admin access for OAuth authorization
Authentication
HubSpot uses OAuth 2.0. Landed handles the OAuth flow automatically -- you will be redirected to HubSpot to authorize access.
Step 1: Connect via OAuth
- In Landed, click Add Connector and select HubSpot
- Click Connect to HubSpot
- You will be redirected to HubSpot's authorization page
- Select the HubSpot account you want to connect
- Review the permissions and click Grant access
- You will be redirected back to Landed
Note: You must be a Super Admin in HubSpot to authorize the connection. If you see a permissions error, ask your HubSpot Super Admin to complete this step.
Required HubSpot Scopes
Landed requests the following OAuth scopes:
| Scope | Purpose |
|---|---|
crm.objects.contacts.read | Read contacts |
crm.objects.companies.read | Read companies |
crm.objects.deals.read | Read deals |
crm.objects.owners.read | Read owners/users |
tickets | Read tickets |
Available Streams
| Stream | Description | Sync Mode | HubSpot Plan Required |
|---|---|---|---|
contacts | Contact records with properties | Incremental | Free |
companies | Company records | Incremental | Free |
deals | Deal/opportunity records | Incremental | Free |
tickets | Support tickets | Incremental | Service Hub Starter+ |
owners | HubSpot users/owners | Full refresh | Free |
engagements | Emails, calls, meetings, notes, tasks | Incremental | Free |
forms | Marketing forms | Full refresh | Marketing Hub Starter+ |
pipelines | Deal and ticket pipelines | Full refresh | Free |
Common Errors
| Error | Cause | Fix |
|---|---|---|
403 Forbidden | Account lacks required scope | Re-authorize the connection as a Super Admin |
401 Unauthorized | OAuth token expired | Landed refreshes tokens automatically. If persistent, disconnect and reconnect. |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
SCOPE_NOT_FOUND | HubSpot plan too low | Upgrade your HubSpot plan for the missing feature |
Data Notes
- HubSpot's API returns data in UTC timezone
- Custom properties are included in contact, company, and deal syncs
- Associations between objects (e.g., which contacts belong to which company) are synced as foreign key fields