HubSpot CRM in Thena

​
Overview

The HubSpot integration enables synchronization of contacts and companies from HubSpot CRM to Thena. This integration helps you maintain consistent customer data across both platforms, streamline your customer relationship management, and enhance your team’s ability to provide personalized service.
  • Contact synchronization: Automatically sync contacts from HubSpot to Thena
  • Company synchronization: Automatically sync companies from HubSpot to Thena
  • Custom field mapping: Map custom fields between HubSpot and Thena
  • Filtered synchronization: Control which contacts and companies are synchronized
  • Audit logging: Track all synchronization activities for troubleshooting

​
Key features

Contact synchronization

  • Sync contact details
  • Map standard and custom fields
  • Filter contacts based on criteria
  • Track sync status and history

Company synchronization

  • Keep company records in sync
  • Map company properties
  • Filter companies by criteria
  • Maintain data consistency

Field mapping

  • Map standard fields automatically
  • Configure custom field mappings
  • Support for various field types
  • Flexible mapping options

Audit logging

  • Track all sync activities
  • View detailed error messages
  • Monitor sync performance
  • Troubleshoot integration issues

Filtered synchronization

  • Set up complex filter rules
  • Include or exclude specific records
  • Filter by any field value
  • Combine multiple filter conditions

​
Setup

You need admin permissions in HubSpot to install the HubSpot integration.
Install the HubSpot integration at the organization level since this feature will be accessible to all teams, as Accounts is an organization-level feature.
1

Begin installation

  1. Navigate to the Apps studio in your Thena dashboard
  2. Find the HubSpot integration in the available apps
  3. Click the “Install” button to begin the installation process
2

Review and configure

  1. Review the permissions and scopes required by the integration
  2. Select “No team” to install HubSpot
3

Complete authorization

  1. After configuration, click “Complete HubSpot authorization”
  2. You’ll be redirected to HubSpot to authorize the connection
  3. Sign in with your HubSpot account and grant the requested permissions
  4. You’ll be redirected back to Thena once authorization is complete
4

Verify connection

  1. Navigate to the HubSpot configuration page
  2. Verify that company and contact sync is enabled
  3. Review the custom fields to import
  4. Optionally set up Filters to import selective data
  5. Click “Save changes” to apply your configuration

​
How to configure synchronization

For both companies and contacts, you can select which fields to synchronize:
  1. Navigate to the HubSpot configuration page in App Studio
  2. Select either the Companies or Contacts tab
  3. Find the “Selected fields” section
  4. Click on the field selector to see available fields
  5. Select the fields you want to synchronize
  6. Click outside the selector to confirm your selection
  7. Click “Save changes” to apply your configuration
Some standard fields are synchronized by default and cannot be deselected, such as name, email, and phone number for contacts.
You can set up filters to control which records are synchronized:
  1. Navigate to the HubSpot configuration page
  2. Select either the Companies or Contacts tab
  3. Find the “Filters” section
  4. Click “Add filter” to create a new filter
  5. Select the field to filter on
  6. Choose an operator (equals, contains, greater than, etc.)
  7. Enter the filter value
  8. Add additional filters as needed
  9. Click “Save changes” to apply your filters
Filters support various operators:
  • Equals / Not equals
  • Contains / Does not contain
  • Greater than / Less than
  • Is empty / Is not empty
  • Starts with / Ends with
  • Is any of / Is none of
Use filters to exclude test or internal records from synchronization. Multiple filters are combined with AND logic.
You can monitor the synchronization status:
  1. Navigate to the HubSpot configuration page
  2. Select either the Companies or Contacts tab
  3. Find the “Sync status” section
  4. View the total count of records in HubSpot
  5. View the count of records synchronized to Thena
  6. Check the status of recent synchronization jobs

​
Permission scopes

The HubSpot app requires specific permissions to function properly and processes events to keep data synchronized between systems.

contacts

Manage HubSpot contacts including:
  • Read contact information
  • Create new contacts
  • Update existing contacts
  • Access contact properties

crm.schemas.contacts

Access to contact schemas:
  • View contact property definitions
  • Access custom property configurations
  • Map custom fields between systems

companies

Manage HubSpot companies including:
  • Read company information
  • Create new companies
  • Update existing companies
  • Access company properties

crm.schemas.companies

Access to company schemas:
  • View company property definitions
  • Access custom property configurations
  • Map custom fields between systems

contact.created & contact.updated

Processes contact changes in Thena:
  • Creates new contacts in HubSpot when added to Thena
  • Updates existing HubSpot contacts when modified in Thena
  • Synchronizes standard and custom field values

account.created & account.updated

Processes account changes in Thena:
  • Creates new companies in HubSpot when added to Thena
  • Updates existing HubSpot companies when modified in Thena
  • Maintains consistent data between platforms

hubspot.contact.synced

Notifies Thena about contact synchronization:
  • Confirms successful contact creation or updates
  • Provides synchronization status information
  • Includes reference IDs from both systems

hubspot.company.synced

Notifies Thena about company synchronization:
  • Confirms successful company creation or updates
  • Provides synchronization status information
  • Includes reference IDs from both systems

​
FAQs

The synchronization process is done everytime there’s a change in the synced record in HubSpot. Or you can manually trigger a synchronization at any time from the configuration page using the sync button.
Yes, custom fields can be synchronized between HubSpot and Thena. You’ll need to select these fields in the field selection section of the configuration page.The integration supports mapping both standard and custom fields. When a custom field exists in HubSpot but not in Thena, the system can create it in Thena automatically based on the field mapping configuration.
Currently, the integration does not automatically handle deletions from HubSpot. When a record is deleted in HubSpot, it will remain unchanged in Thena.
There is no specific limit imposed by Thena on the number of HubSpot records you can synchronize. However, the integration respects HubSpot’s API rate limits.For large data sets, synchronization may take longer due to these rate limits, but the system implements rate limiting and retry mechanisms to handle this gracefully.
Yes, you can use filters to exclude specific records from synchronization. Configure these filters in the filters section of the configuration page.The integration supports various filter operators including:
  • Equals
  • Not equals
  • Greater than
  • Less than
  • Contains
  • In list
Filters are validated to ensure they reference valid fields that are selected for synchronization.
If you’re experiencing authentication issues:
  1. Check if your HubSpot OAuth token has expired
  2. Verify that your HubSpot subscription is active
  3. Try uninstalling and reconnecting the integration:
    • Go to the integration settings page
    • Click “Uninstall”
    • After uninstalling, click “Install” to restart the OAuth flow
The system will automatically attempt to refresh expired OAuth tokens, but if the refresh token is also invalid, you’ll need to reconnect the integration.
If synchronization is failing:
  1. Check the audit logs for specific error messages (look for entries with status “FAILED”)
  2. Verify that your filters are valid and not too restrictive
  3. Check for HubSpot API rate limit issues
  4. Verify network connectivity between Thena and HubSpot
The system implements retry mechanisms for failed jobs, but persistent issues may require manual intervention.
If data is missing after synchronization:
  1. Confirm that the fields are selected for synchronization in the field mapping configuration
  2. Check if filters are unintentionally excluding the expected records
  3. Verify that the records exist in HubSpot
  4. Ensure field mapping is correctly configured for the missing data
  5. Check the audit logs for any errors related to specific records
Note that some complex field types may not be supported by the integration.