Monocle HubSpot Integration

Knowledge Base Documentation

Overview

Monocle integrates with HubSpot to provide Customer Success Managers with a unified view of their customer relationships. This integration enables bidirectional synchronization of customer data between Monocle and HubSpot, helping teams stay aligned and work more efficiently.

What Data We Sync

The Monocle-HubSpot integration synchronizes the following data types:

  • Companies: Customer account information including name, domain, and custom properties
  • Contacts: Individual contact records associated with companies
  • Notes: Company notes and annotations

Associations between these data types are also synchronized, so relationships between companies, contacts, and notes remain consistent across both platforms.

How Authentication Works

Monocle uses OAuth 2.0 to securely connect to your HubSpot account. When you connect HubSpot:

  1. You are redirected to HubSpot's authorization page
  2. You log in with your HubSpot credentials and authorize Monocle
  3. HubSpot returns an access token that Monocle uses to sync data on your behalf

Important: Monocle only syncs data that is assigned to the HubSpot user who authenticated via OAuth. This means you will only see companies, contacts, and notes where you are the designated owner in HubSpot.

Your HubSpot account does not need to use the same email address as your Monocle account. The integration identifies you based on your HubSpot owner ID.

Bidirectional Sync

The integration supports full bidirectional synchronization. You can perform create, read, update, and delete (CRUD) operations in either Monocle or HubSpot, and changes will sync automatically between the two platforms.

This includes:

  • Creating new companies, contacts, or notes in either system
  • Updating existing records in either system
  • Deleting records from either system
  • Changing associations between companies, contacts, and notes

Data Privacy and Security

Monocle takes data security seriously. All data transmitted between Monocle and HubSpot is encrypted in transit. Access tokens are stored securely and are only used to sync data on your behalf.

You can disconnect your HubSpot integration at any time from the Integrations page in Monocle. Disconnecting will immediately revoke Monocle's access to your HubSpot data.

For more details on how we handle your data, please refer to our Privacy Policy.

Scopes and Permissions

Monocle requests the following HubSpot OAuth scopes:

  • crm.objects.companies.read/write: To sync company records
  • crm.objects.contacts.read/write: To sync contact records
  • crm.objects.deals.read/write: To access deal information
  • sales-email-read: To access email engagement data
  • crm.schemas.contacts.read: To understand contact data structure
  • oauth: For secure authentication

These permissions allow Monocle to provide full synchronization functionality while limiting access to only the data necessary for the integration.

Coming Soon: Team Support

We are actively developing team and organization-level features for the HubSpot integration. Upcoming enhancements include:

  • Team-wide sync: Sync data across your entire team, not just individual users
  • Role-based access: More granular control over who can view and edit synced data
  • Enhanced permissions: Integration with HubSpot roles for more robust data scoping

These features will enable organizations to manage customer data more effectively across their Customer Success teams.

Getting Started

  1. Log in to your Monocle account
  2. Navigate to the Integrations page
  3. Click Connect HubSpot
  4. Authorize Monocle in the HubSpot OAuth flow
  5. Your data will begin syncing automatically

Support

If you have questions or need assistance with the HubSpot integration, please contact us at support@snowisetech.com.