Docs

Admin Guide

Admin Guide / Integrations / HubSpot

Connect HubSpot to Rox

Connect your HubSpot CRM to Rox to bring your companies, contacts, and deals into the platform. Rox helps you research accounts, surface insights, and help your team prepare for customer interactions.

This guide walks through authorizing HubSpot, connecting Fivetran, and verifying that your data is syncing.

Before you start

You'll need:

  • Rox Organization Admin access: Only an Organization Admin can connect a CRM integration.

  • HubSpot authorization permissions: We recommend using a HubSpot Super Admin or an account with the permissions needed to install and authorize third-party applications.

  • Your HubSpot portal ID: You'll select a HubSpot account twice during setup. Both authorizations must use the same portal.

We recommend connecting the HubSpot portal your team uses in production.

Important: Setup requires two separate authorizations: one for Rox and one for Fivetran. Data will not begin syncing until both are complete.

Existing HubSpot connections

The updated HubSpot onboarding experience is available to all organizations.

If your organization already has an active HubSpot connection, you can opt in to the upgraded configuration experience. This provides access to the updated object selection, deal-stage mapping, field mapping, and account assignment workflows.

Existing connections do not need to repeat the initial authorization process to continue syncing HubSpot data.

1. Connect HubSpot to Rox

  1. Sign in to Rox.

  2. Select your username in the bottom-left corner and open Settings → Integrations.

  1. Find HubSpot and select Connect (or Action Required, if shown).

  1. In the integration dialog, select Connect HubSpot.

  1. On the HubSpot sign-in screen, select Sign in to your HubSpot account.

  2. Sign in using your HubSpot credentials or your organization's identity provider.

  3. Under Choose an account, select the HubSpot portal containing your CRM data.

  4. Confirm the portal ID and select Choose Account.

  5. Review and approve the requested permissions.

You'll return to Rox, where the first connection step should display Completed.

Note: Do not select Create a new HubSpot account during authorization. This creates an empty portal rather than connecting your existing CRM.

2. Authorize Fivetran

Rox uses Fivetran to securely ingest HubSpot data into the managed warehouse used by the platform.

  1. Return to the HubSpot integration dialog in Rox.

  2. Select Map Key Values under the Fivetran authorization step.

  1. Review the Fivetran notice and select Continue.

  1. If the HubSpot integration displays Action Required, reopen it and select Map Key Values again.

  1. In the Fivetran connector setup, review the Historical sync time frame. The default is Sync all historical data.

  2. Select Authorize.

  1. Choose the same HubSpot portal you selected in the first connection step.

  2. Review the requested HubSpot permissions and select Connect app.

  1. Confirm the connector displays Authentication Succeeded.

  2. Select Save & Test.

Important: Select Save & Test, not Save for later. Saving for later does not activate the connector or begin synchronization.

About HubSpot permissions

The Fivetran HubSpot connector requests permissions to access CRM objects and their properties.

Some permissions are required for the connection. Others are optional and can be adjusted during authorization.

If your organization needs to restrict the requested permissions, review the available options with your Rox account team before completing setup. Removing access may affect which data Rox can synchronize.

3. Select objects to sync

After connecting HubSpot and Fivetran, select the HubSpot objects you want Rox to synchronize.

  1. Review the available HubSpot objects.

  2. Select the optional objects your organization needs, such as Contacts and Deals.

  3. Companies and Owners are required.

  4. Continue to the next configuration step.

4. Map deal stages

If you selected Deals during object selection, configure how your HubSpot deal pipeline maps to opportunity stages in Rox.

  1. Select the HubSpot Pipeline your sales team uses to manage Deals.

  1. Map each HubSpot deal stage to the corresponding Rox opportunity stage.

  1. Review the mappings to ensure they reflect your organization's sales process.

  2. Select Continue to proceed to field mappings.

Note: Rox supports one HubSpot deal pipeline. Only Deals from the selected pipeline appear as Opportunities in Rox.

If you did not select Deals during object selection, this step is skipped.

5. Configure field mappings

Field mappings determine how HubSpot properties correspond to fields in Rox.

  1. Select the relevant object tab, such as Company, Contact, or Deal.

  2. Review the default mappings between HubSpot properties and Rox fields.

  3. Select the appropriate HubSpot property for each Rox field.

  4. Keep required mappings in place and adjust optional mappings as needed.

  5. Select Continue to proceed to account assignment.

You can create or update custom field mappings after onboarding under Settings → Integrations → HubSpot → CRM Mappings.

6. Configure account assignment

Account assignment determines which synchronized HubSpot Accounts each Rox user can access.

  1. Review the assignment rule for each user.

  1. Under Owner fields, select the HubSpot Account-to-User fields used to assign Accounts. Most organizations use the standard Owner field, but supported custom owner fields can also be selected.

  2. Under Account filters, optionally add a filter to further restrict which Accounts are assigned.

  3. Under Default rule, configure the assignment behavior for users without individual owner fields or filters.

  4. Select Preview to verify which Accounts each user will receive.

  1. Save the configuration and continue to the next step.

A user can have multiple owner fields and one additional account filter. Users without a matching assignment rule will not see Accounts in Rox.

After onboarding, you can update assignment rules under Settings → Integrations → HubSpot → Account Assignment.

7. Test sync

Before completing setup, test the HubSpot integration to verify that the configuration is valid.

  1. Select Test sync.

  1. Review any errors or warnings returned by the test.

  2. If an issue is identified, return to the relevant onboarding step, correct the configuration, and run the test again.

  3. Once the test succeeds, select Submit to finalize the connection.

After submission, Fivetran begins the initial synchronization. HubSpot records will appear in Rox once the synchronization completes.

You can return to Settings → Integrations → HubSpot to review the connection and manage its configuration.

Verify your data in Rox

After you submit the configuration, Fivetran begins the initial synchronization. The first sync typically takes at least 30 minutes and may take several hours for larger HubSpot portals.

Once synchronization completes, confirm that the expected Accounts, Contacts, and Opportunities are available in Rox.

You can return to Settings → Integrations → HubSpot to review the connection status.

Troubleshooting

  • The HubSpot connection fails or returns a permissions error: Confirm that you have Organization Admin access in Rox and the necessary permissions to authorize the application in HubSpot.

  • The integration still displays Action Required: Reopen the Fivetran connector and confirm that authentication succeeded. If necessary, repeat the Fivetran authorization and select Save & Test.

  • The integration shows a failed status: A previous or incomplete connection attempt may be interfering with the new connection. Contact your Rox account team rather than repeatedly retrying the authorization.

  • The wrong HubSpot portal was connected: Contact your Rox account team before disconnecting or attempting to reconnect. The existing connection may need to be cleared.

  • No accounts appear after synchronization: Confirm that the initial synchronization has completed. If data has synchronized successfully but users cannot see their accounts, review the organization's account assignment rules.

  • Reauthenticate a connection: If the integration requires action or its authorization has expired or been revoked:

    • Open Settings → Integrations → HubSpot.

    • Open the integration settings.

    • Select Re-authenticate and sign in using the appropriate HubSpot account.

    • If Fivetran also requires authorization, reconnect it and select Save & Test.

    • Return to Rox and confirm the connection is healthy.

Next steps

Once HubSpot is connected, your team can use synchronized CRM data throughout Rox.

See Syncing with HubSpot to learn about supported objects, field mappings, deal pipelines, account assignment, and integration limitations.

If you need assistance, contact your Rox account team or help@rox.com.

Rox is committed to the privacy and security of its users. Customer data processed through the Rox platform is encrypted in transit and at rest using AES-256 encryption and is never used to train generalized machine learning models. Rox maintains SOC 2 Type II compliance and undergoes independent third-party security audits on an annual basis. All AI-generated outputs, including but not limited to prospect recommendations, message drafts, meeting summaries, and pipeline scoring, are provided for informational purposes and should be reviewed by authorized personnel before any action is taken. Performance metrics referenced on this website, including pipeline generation figures, response rates, and revenue impact, reflect results reported by individual customers under specific configurations and may not be representative of all deployments. Actual results will vary based on factors including but not limited to data quality, CRM configuration, outreach volume, market conditions, and target audience. Rox does not guarantee specific revenue outcomes. The Rox platform integrates with third-party services including Salesforce, HubSpot, Gmail, Microsoft Outlook, Slack, and others; availability and functionality of third-party integrations are subject to the respective providers' terms of service and may change without notice. Features described as "autopilot," "autonomous," or "automated" operate within user-defined parameters and require initial configuration and ongoing oversight. Rox, the Rox logo, and "Revenue on Autopilot" are trademarks of Rox Data Corp. All other trademarks are the property of their respective owners. Service availability is subject to the terms outlined in your enterprise agreement. For questions regarding data processing, compliance certifications, or platform capabilities, contact security@rox.com.

Rox is committed to the privacy and security of its users. Customer data processed through the Rox platform is encrypted in transit and at rest using AES-256 encryption and is never used to train generalized machine learning models. Rox maintains SOC 2 Type II compliance and undergoes independent third-party security audits on an annual basis. All AI-generated outputs, including but not limited to prospect recommendations, message drafts, meeting summaries, and pipeline scoring, are provided for informational purposes and should be reviewed by authorized personnel before any action is taken. Performance metrics referenced on this website, including pipeline generation figures, response rates, and revenue impact, reflect results reported by individual customers under specific configurations and may not be representative of all deployments. Actual results will vary based on factors including but not limited to data quality, CRM configuration, outreach volume, market conditions, and target audience. Rox does not guarantee specific revenue outcomes. The Rox platform integrates with third-party services including Salesforce, HubSpot, Gmail, Microsoft Outlook, Slack, and others; availability and functionality of third-party integrations are subject to the respective providers' terms of service and may change without notice. Features described as "autopilot," "autonomous," or "automated" operate within user-defined parameters and require initial configuration and ongoing oversight. Rox, the Rox logo, and "Revenue on Autopilot" are trademarks of Rox Data Corp. All other trademarks are the property of their respective owners. Service availability is subject to the terms outlined in your enterprise agreement. For questions regarding data processing, compliance certifications, or platform capabilities, contact security@rox.com.