Advanced Analytica Advanced Analytica: IBOM
← All connectors
HubSpot logo

Destination connector

HubSpot

Send governed data into HubSpot with a clear, practical setup guide.

Version 0.0.13 community alpha

dockerRepository: airbyte/destination-hubspot

HubSpot destination

Set up the HubSpot destination connector by following this guide. The connector supports data activation for operational workflows.

Prerequisites

  • A HubSpot account
  • Airbyte version 1.8 or later, or Airbyte Cloud

S3 prerequisites for rejected records

If you use an S3 bucket to store rejected records, you’ll also need the following.

  1. Allow connections between Airbyte and your AWS S3/Minio S3 cluster if they’re in separate VPCs.

  2. Enforce encryption of data in transit.

  3. An S3 bucket with credentials, a Role ARN, or an instance profile with host read/write permissions configured for EC2 or EKS.

    • These fields are always required:

      • S3 Bucket Name
      • S3 Bucket Region
      • Prefix Path in the Bucket
    • If you use STS Assume Role, you must provide:

      • Role ARN
    • If you use AWS credentials, you must provide:

      • Access Key ID
      • Secret Access Key
    • If you use an Instance Profile, you can omit the Access Key ID, Secret Access Key, and Role ARN.

Setup guide

Set up HubSpot in Airbyte

  1. Log in to your Airbyte account.

  2. Select Destination, then select + New destination.

  3. On the Set up the destination page, select HubSpot from the Destination tiles.

  4. Enter a name for the HubSpot connector.

  5. OAuth authentication is available from the Authentication dropdown. Select Authenticate your HubSpot account to sign in with HubSpot and authorise your account.

    :::note HubSpot authentication issues The popup window may display the error An invalid scope name was provided during authentication. Close the window and retry authentication. :::

  6. Select Set up destination and wait for the tests to finish.

Supported sync modes

Sync modeSupported?
Full Refresh - OverwriteNo
Full Refresh - AppendYes
Full Refresh - Overwrite + DedupedNo
Incremental Sync - AppendYes
Incremental Sync - Append + DedupedNo

This is a data activation destination. Alongside the Airbyte sync modes above, HubSpot supports per-object write operations: insert, upsert, update, and soft delete. Configure these operations in the connection settings.

Supported objects

The HubSpot destination connector supports these streams:

Limitations and troubleshooting

Rate limits

The connector automatically follows HubSpot’s standard API rate limits. If rate limiting occurs, the connector retries requests with exponential backoff.

Missing destination objects

For every object except CONTACT, which uses email as its matching key, upsert requires a unique value field on the destination object.

Matching Key Requirements:

  • CONTACT: Uses email field automatically
  • All other objects: Requires a property with unique values enabled

Create a unique value property in HubSpot:

  • From the CRM menu on the left, select the object you want to sync
  • Under Actions, select Edit Properties
  • Select Create property
  • When entering the rules, select Require unique values for this property

App verification

HubSpot requires application usage, such as more than 60 installations, before verifying the HubSpot application. During installation, you might see “You’re connecting to an unverified app”. This warning is expected for the first users. Once the application receives enough traffic, it can be verified and the warning will disappear.

Scopes for unsupported streams

During app installation, you might see scopes for unsupported objects. This is expected because changing scopes might require users to re-authenticate, which can be disruptive. To avoid this, scopes were added for objects intended for future support based on user demand.

403 Forbidden error

Hubspot has scopes for each API call. Each stream is linked to a scope and requires access to sync data. Review the Hubspot OAuth scope documentation here.

Namespace support

This destination doesn’t support namespaces.

Changelog

Expand to review
VersionDatePull RequestSubject
0.0.132026-11-1091834Fix HubSpot OAuth authorization by sending the PKCE code_challenge_method and code_verifier
0.0.122026-06-1780214Move to community support level
0.0.112026-04-1576336Upgrade Bulk CDK to 1.0.8 (OAuth token expiry fix)
0.0.102026-02-0972975Upgrade CDK to 1.0.1
0.0.92026-01-2672304Upgrade CDK to 0.2.0
0.0.82025-11-0569131Upgrade to Bulk CDK 0.1.61.
0.0.72025-09-2466684Pin to CDK artifact
0.0.62025-09-1065986Adding product object
0.0.52025-09-0865157Update following breaking changes on spec
0.0.42025-07-3164144OSS release
0.0.32025-07-18205Forcing new release
0.0.22025-07-18204Fixing auth
0.0.12025-07-18201First iteration internally
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.