Skip to main content

Troubleshooting for HubSpot Reader

This topic describes errors you may see when using the HubSpot Reader, and possible resolutions.

Exception

Resolutions

HubSpotCredentialsException

  • Verify Auth Mode is set correctly (OAuth or Private app token).

  • For OAuth: confirm Client ID, Client secret, and Refresh token are valid and belong to the same HubSpot app.

  • For Private app token: ensure the token is current and pasted without extra spaces or line breaks.

HubSpotPermissionException

  • Grant the required scopes for each object you read (see Supported objects for scope lists).

  • If using a Private app token, edit the token’s permissions to include the missing scopes.

  • If using OAuth, re-authorize the app after adding scopes so the refreshed token includes them.

HubSpotRateLimitExceeded (HTTP 429)

  • Reduce concurrency: lower Thread pool count and/or Connection pool size.

  • Increase Polling interval to make fewer API requests.

  • Honor the Retry-After header; allow the reader to back off rather than restarting repeatedly.

  • Limit the number of tables polled per application or split work across multiple schedules.

HubSpotInvalidTableNamesException

  • Check Tables and Exclude tables: use exact object names, a semicolon (;) delimiter, and the % wildcard where needed.

  • Remove typos or unsupported objects; verify the object exists in your HubSpot account and API.

  • Do not change Tables while recovery is enabled; stop the app first if changes are required.

HubSpotStartPositionInvalidException

  • Use a valid Start position format (for example, %=-1 to start from the latest).

  • Ensure the value corresponds to the Incremental load marker type (for example, a timestamp or numeric marker depending on object).

  • When recovering, the checkpoint position overrides Start position; clear recovery state only if you intend to restart from a new position.

HubSpotPollingIntervalParseException

  • Specify an integer followed by a unit: d, h, m, or s (for example, 5m).

  • Avoid spaces (use 10s, not 10 s).

HubSpotConnectionException / TLS errors / timeouts

  • Verify outbound HTTPS access to HubSpot APIs from the Striim host (firewall, proxy, or VPN settings).

  • Ensure system time is accurate; large clock skew can break OAuth and TLS handshakes.

  • If a corporate proxy is required, configure proxy environment variables on the Striim host and restart the app.

HubSpotIncrementalMarkerMissing

  • Confirm the configured Incremental load marker exists for all selected objects (default is Last_Modified_Date for many objects).

  • For objects without a reliable marker, use Automated mode or perform periodic full resyncs.

HubSpotThreadPoolConfigurationException

  • Size Connection pool size to at least the Thread pool count for best performance and stability.

  • Reduce threads during high-volume ingestion if you observe throttling or memory pressure.

HTTP 400/401/403/404 from HubSpot API

  • 400 Bad Request: review object names and parameters; remove unsupported fields or filters.

  • 401 Unauthorized: recheck credentials or re-authorize OAuth; tokens may be expired or revoked.

  • 403 Forbidden: add the missing scopes or permissions to your OAuth app or Private app token.

  • 404 Not Found: verify the object or endpoint is available in your account and API version.