Docs
UI Guides

Connect HubSpot

Connect HubSpot to use CRM data in Encelade charts and statistics.

Connect your HubSpot account to use CRM data in your presentations. The basic connector reads contacts, companies, deals, and deal properties. It does not create or change records in HubSpot.

Before you connect

You need an Encelade account and access to the HubSpot account you want to connect. Use a HubSpot user who has permission to install apps and grant the permissions shown during authorization. If you cannot grant them, ask your HubSpot administrator to help.

Connect your account

  1. In Encelade, open Settings and choose Connectors.
  2. Under Connect a source, find HubSpot and select Connect.
  3. Sign in to HubSpot if prompted, then choose the account that contains your CRM data.
  4. Review the requested permissions and authorize the connection.
  5. After returning to Encelade, check that the account appears under Active connections.

To use HubSpot data in a chart or statistic, select the layer, choose HubSpot as its data source, then select the account and the metric. Charts also take a time range. See Data connectors.

Permissions and data access

Encelade requests OAuth access and read permissions for contacts, companies, deals, and deal-property definitions. These permissions let Encelade query CRM data and interpret deal fields for charts and statistics.

The basic connection does not request permission to write CRM records or publish timeline events. You can separately enable deal write-back from a presentation's share panel.

Deal linking requires Pro or above. On lower plans the section shows a Pro badge and an Upgrade button.

  1. Open your presentation's Share panel and expand CRM connection.
  2. If you haven't connected HubSpot yet, select Connect HubSpot. If you connected it from Settings, select Reconnect HubSpot. Either way, authorize deal updates and the creation of Encelade's deal properties.
  3. Back in the presentation, select Link a deal. If you have more than one HubSpot account connected, choose the account first.
  4. Search for the deal and choose it.

Encelade then writes these to the deal's Encelade properties: the presentation link, when it was last viewed, total views, unique viewers, whether pricing was viewed, the proposal status, and the date the proposal was accepted. Timeline cards require a separately configured HubSpot capability. Calculator inputs and results stay in Encelade.

The section shows the sync state: Synced with a time, Sync pending, Sync failed or Reconnect needed. Select Retry or Resume sync to try again. Select Unlink to stop future writes for that presentation.

For data-handling details, read our Privacy Policy. For help with your connection or data, visit Support.

Disconnect

Open Settings › Connectors, find HubSpot under Active connections, and select Remove. Confirm with Remove. Charts and statistics that use the connection stop updating. You can also manage Encelade's app access from your HubSpot account's connected-app settings.

Disconnecting does not delete CRM records in HubSpot. If you need help removing data already used in a presentation, contact support.

Troubleshooting

The account is not eligible to install Encelade

This message can indicate an app-distribution restriction, even when you are a HubSpot administrator. Contact support with your HubSpot account ID and a screenshot of the message. Do not send passwords, access tokens, or secret keys.

HubSpot reports a permissions or scope error

Start a new connection from Encelade's Connectors settings instead of reusing an old authorization link. If the error remains, send support the error text and your HubSpot account ID. An administrator cannot fix a mismatch in Encelade's registered app permissions; the Encelade team must resolve it.

CRM sync asks me to reconnect

Use Reconnect HubSpot in the presentation's share panel and authorize the additional deal-write permissions. Connecting again from Settings only requests read access. Use the HubSpot account that owns the linked deal. If a colleague connected it, ask them to reconnect their account.