Skip to content
Help Center
Submit a request Sign in

Connect support and account teams with HubSpot synchronization

The HubSpot integration connects the support team’s customer context with the account team’s CRM work. It can bring supported Company and Contact information into Supportbench and export Supportbench cases as HubSpot tickets, so a commercial conversation can take account of open service work. Each object has its own direction and settings. Plan those flows deliberately so people know which system owns a field and where a support action should take place.

At a glance

For: support operations leads, account teams and administrators planning the HubSpot integration. Applies to: Supportbench Core.

Start here: Settings → Integrations → HubSpot; the linked Company, Contact and case records

Decide what the integration should help your teams do  ·  Understand the direction of each flow  ·  Prepare the connection and operating choices  ·  Assign field ownership before turning on synchronization  ·  Example: support and account teams coordinate a customer escalation  ·  Verify a representative workflow end to end  ·  Troubleshoot missing or unexpected records

Decide what the integration should help your teams do

Start with an operational problem: account managers lack visibility of an important case, agents repeatedly re-enter customer information, or specialist CRM data is missing from customer context. Identify the specific records and fields needed to address that problem. Enabling every available flow is not a substitute for an agreed ownership model.

  • Agree who maintains Company identity and the fields that will be imported.
  • Decide whether Contacts should be created, updated, exported or synchronized in both supported directions.
  • Choose which Supportbench cases should appear as HubSpot tickets and how open/closed states should map.
  • Identify who monitors synchronization failures and who resolves conflicting or duplicate customer records.
  • Explain to both teams where customer replies must be sent and how internal collaboration notes are handled.

In B2B support, one Company can have many Contacts and several simultaneous cases. A useful integration preserves those relationships so an account conversation refers to the correct people and issues. It should not collapse every email or every case into a single undifferentiated customer status.

Understand the direction of each flow

Object or actionSupported direction or modeOperational implication
CompaniesDisabled or Import from HubSpot into SupportbenchDefine HubSpot-owned fields and review filters/mappings before relying on imports.
ContactsDisabled, Create/update, Update existing, Export, Import + Export or Update existing + ExportThe selected mode controls whether new Contacts can be created and whether export is included. Contacts are not always bidirectional.
TicketsSupportbench cases export to HubSpot ticketsThe case’s linked Company must already have a recorded HubSpot external ID; cases without one are excluded from ticket export. A Contact external ID is optional for the ticket association. This flow is export-only, not two-way ticket synchronization or HubSpot-ticket import.
Notes on the linked exported HubSpot ticketImported as private/internal Supportbench notes when Ticket export is enabled and the HubSpot ticket is linked to an exported Supportbench caseThese notes provide internal context. They are not customer replies.
Supported HubSpot custom objectsOptional import into configured Data TablesReview the chosen schema, mappings and Company or Contact relationship. This does not make every custom object available automatically.

Do not infer one object’s behavior from another

A Contact mode that includes Import + Export does not make Tickets bidirectional. Likewise, importing a HubSpot ticket note does not import the entire ticket as a new Supportbench case. Review each configured flow independently.

Prepare the connection and operating choices

  1. Open Settings → Integrations → HubSpot with the necessary integration administration access. Confirm the intended HubSpot account and the authority to connect it.
  2. Use an approved HubSpot private app and the required provider permissions/scopes for the selected objects. Enter its Private app token only in the intended connection field. Keep the secret out of knowledge articles, case notes and screenshots.
  3. Use Test connection and confirm the result for the intended account. A successful connection does not prove that every field mapping or ticket stage is correct.
  4. Set a monitored Failure notification email and name the person responsible for investigating errors.
  5. Review the separate Company, Contact, Ticket and optional Table settings using the full configuration reference below.
  6. For Ticket export, confirm that the case’s linked Supportbench Company is correctly linked to a HubSpot Company and has a recorded HubSpot external ID. Enabling export alone does not supply this prerequisite. Then choose the intended Pipeline, Open stage and Closed stage. Review the lookback period and eligible scope before enabling export.
  7. Start with a representative, authorized record and verify both systems before broad operational use.

The ticket lookback options are 1, 7, 14, 30, 60 or 90 days. Choose the period for your actual objective; a broad lookback can bring considerably more historical work into the CRM than an account team expected. Filters, Only active choices and mappings also affect which supported records qualify.

Assign field ownership before turning on synchronization

For each mapped field, write down its meaning, source of truth, direction and intended downstream use. “Company name” and “Support tier” may have different owners. A sales classification should not silently become a contractual support promise unless the organization has defined and verified that behavior.

Planning questionWhy it matters
Who can create a Contact?Create/update and Update existing express different intentions. Choose deliberately to avoid expecting a missing record to be created by an update-only mode.
Which system owns the field?Teams need to know where to correct inaccurate data and whether a later synchronization may replace a local edit.
Which records are included?Filters, active-state choices and lookback can explain an absent record without a connection failure.
How is the customer linked?Check the actual source IDs and Company/Contact relationships; a similar display name alone is insufficient proof.
What does open or closed mean for the CRM?The chosen HubSpot pipeline stages must represent the intended service lifecycle.
Who handles errors?A monitored mailbox and clear owner prevent silent drift between systems.

If duplicate customer records already exist, assess them before enabling a broader creation mode. Use the established merge and customer-management procedures rather than expecting synchronization to understand every duplicate or organizational relationship automatically.

Example: support and account teams coordinate a customer escalation

A business customer has an unresolved integration issue while its account team prepares a service review. The support team keeps the case investigation, ownership, activities and service commitments in Supportbench. The integration exports the eligible case as a ticket in the selected HubSpot pipeline so the account team can see the relevant service context.

  1. The agent verifies the case’s Company and Contact and records a useful current status in Supportbench. The integration administrator confirms that the linked Company has its HubSpot external ID before expecting ticket export.
  2. The integration exports the eligible case to HubSpot. The account team checks that the ticket represents the correct case and customer rather than relying only on a similar subject.
  3. An account colleague adds relevant internal context to the linked HubSpot ticket note, such as a planned review meeting. Under the configured flow, that note is imported as an internal Supportbench note.
  4. The case owner reads the imported note, assesses the impact and records the next action. The note does not itself send a customer reply or change a service commitment.
  5. When a customer update is needed, the owner uses the normal Supportbench activity workflow, verifies recipients and sends the reviewed message.
  6. The teams verify the exported ticket stage against the case lifecycle and investigate synchronization errors if the expected status does not appear.

This keeps the CRM conversation informed while retaining a clear support operating process. It does not replace the need for an accountable case owner, nor does it promise that an internal CRM comment reaches the customer.

Verify a representative workflow end to end

  1. Confirm connection status and the selected object modes in Supportbench.
  2. Choose a representative included Company and Contact. Compare identity, relationship and mapped field values on both sides.
  3. Check an intentionally excluded record so filters are tested as well as successful imports.
  4. For Ticket export, verify the case’s linked Company has a recorded HubSpot external ID, then inspect the eligible case and its HubSpot ticket, including pipeline and open/closed stage. Also check an unmapped Company case: it should not be assumed eligible merely because export is enabled.
  5. Where internal note import is part of the process, use an approved test case/note or safe test tenant. Adding the note on the linked exported ticket creates a private/internal activity on that Supportbench case; verify this deliberate data change.
  6. Review Refresh status, the integration’s error information and the data synchronization log as applicable. Record the evidence and expected processing behavior.
  7. Tell agents and account colleagues which flows were verified and who to contact when records disagree.

Do not repeatedly change mappings, remove the integration or widen the lookback while a prior synchronization outcome is still uncertain. Inspect the actual linked records and errors first. Disabling or removing an integration is a separate operational action with dependencies to review.

Troubleshoot missing or unexpected records

SymptomChecks and corrective direction
The connection failsCheck the intended provider account, approved token and required scopes. Use Test connection and investigate the displayed error without sharing the credential.
A Company is missingCheck that Companies Import is enabled, eligible active/filter rules and mappings; verify the HubSpot source record.
A new Contact is not createdCheck the Contact mode. Update existing is different from Create/update or an import mode that allows creation.
An exported Contact differs from the sourceReview mode, mapped fields, ownership and actual record IDs before editing both systems independently.
A case has no HubSpot ticketFirst confirm Tickets Export is enabled and the case’s linked Company has a recorded HubSpot external ID; cases without it are excluded before ticket creation. Import/synchronize or correctly link the Company through the supported integration process, then verify the next synchronization. A Contact external ID is optional. Also check lookback, other eligibility, pipeline/open/closed stages and synchronization errors.
A HubSpot ticket never appears as a new caseTicket import is not supported by this configuration. Cases export from Supportbench.
A HubSpot note has not appearedConfirm it belongs to the linked exported ticket and that the relevant export flow and processing are working.
The imported note did not email the customerExpected: it is private/internal context. Send a deliberate customer activity through the normal case workflow if needed.
Custom-object data is missingCheck the enabled Table, selected object/schema, mappings and Company/Contact relationship.
The two systems show different case statusCompare actual export eligibility, mapped stages, latest processing result and recorded case lifecycle before treating the CRM display as authoritative.

Was this article helpful?