BigQuery
Read and write support varies by record
Record types covered in the setup guide
| Record types | Coverage and requirements |
|---|---|
| See connector requirements. Confirm field permissions and sync direction. |
Keep supported BigQuery and HubSpot records aligned with two-way sync. Give each team access to current data while controlling which system can update each field.
Example workflow
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Starting eventA change involving the proposed company table in BigQuery or HubSpot Company needs a defined result in the other system.
Start with the proposed company table in BigQuery and HubSpot Company. Use the record-matching and field-ownership rules from your mapping worksheet.
Resolve parent organizations, business units, and currency references before dependent transactions.
Test a normal update and one failed or repeated update in the supported direction. Keep both record IDs with the test results.
What to verifyUse two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only.
Review records and field ownershipMapping essentials
Match records by stable IDs and assign an owner for each field. The record notes identify the coverage to check.
Download the mapping worksheetCSV · No email required
| BigQuery record | HubSpot record | Record matching | Field ownership |
|---|---|---|---|
| Proposed company tableProposed table; choose its name and schema.Reporting dataset | CompanyDocumented record: Supported | Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient. | Assign ownership separately for relationship details and finance-controlled billing details. |
| Proposed contact tableProposed table; choose its name and schema.Reporting dataset | ContactDocumented record: Supported | Use a stable person/contact ID and an explicit cross-system lookup. Email can change and can be shared, so treat it as a matching clue rather than a universal key. | Keep consent and communication preferences under an agreed authority; a general contact update must not silently resubscribe someone. |
| Proposed deal or opportunity tableProposed table; choose its name and schema.Reporting dataset | DealDocumented record: Supported | Keep the opportunity/deal ID separate from any later order or invoice ID. | The sales process owns qualification and stage changes; downstream financial records have their own state and approval rules. |
Use writable fields from the connected accounts. Read values from read-only fields without writing changes back to them, and define deletion handling separately.
Why teams connect BigQuery and HubSpot
Start with the work your team needs to complete: keep records up to date, make operational data available for reporting, or move data to a new system. Choose one BigQuery and HubSpot workflow to test, define what success looks like, and decide who handles failed updates.
Build board-level pipeline dashboards on BigQuery instead of HubSpot's native reports.
Enrich HubSpot Contacts with attributes calculated from warehouse Tables, kept current by two-way sync.
Analyze Ticket volume against Deal size in BigQuery to price support into renewals.
Start with the records your workflow needs. Check each system’s read and write requirements before mapping fields.
Read and write support varies by record
Record types covered in the setup guide
| Record types | Coverage and requirements |
|---|---|
| See connector requirements. Confirm field permissions and sync direction. |
Read and write support varies by record
Record types covered in the setup guide
| Record types | Coverage and requirements |
|---|---|
| ✅ Supported. Confirm field permissions and sync direction. |
| 🕘 Coming soon. Confirm field permissions and sync direction. |
| ❌ Not supported. Confirm field permissions and sync direction. |
Review how each system connects, detects changes, and permits access to your records.
View setup requirements and limits| Connection requirement | BigQuery | HubSpot |
|---|---|---|
| Integration interface | GoogleSQL via the BigQuery REST API, client libraries, JDBC/ODBC drivers, and the Storage Read/Write APIs | REST API (CRM v3) |
| Authentication | Dedicated Google Cloud service account and JSON key | OAuth |
| Change detection | The setup provisions notification services using Eventarc and Cloud Run in the customer Google Cloud project. | Record updates and association changes need separate validation. |
| Read access | Available for supported records | Available for supported records |
| Write access | Available for supported records | Available for supported records |
Enterprise controls
As a data company, we understand the importance of keeping your data secure. Stacksync is built with security best practices to keep your data safe at every layer, and is DPF-certified for US, EU, UK and CH data transfers.
Let your users access Stacksync from your centralized user management systems. Works with Okta, Azure, Google SSO and more.
Immediately get alerted about record syncing issues over email, Slack, PagerDuty and WhatsApp. Resolve issues from a centralized dashboard with retry and revert options.
Securely connects to your systems with:
Inspect sync errors and use retry and revert controls to resolve failed updates.
Read the recovery guideImplementation
Review setup, record relationships, testing, and recovery for your implementation.
Documentation reviewed 2026-09-15. Check the linked guides for current account and record requirements.
Documentation reviewed 2026-09-15. Check the linked guides for current account and record requirements.
Set up both accounts before testing the mapping. Use test records where available, and identify the account administrator who can approve access and help resolve setup errors.
Setup guides: Authorize BigQuery
Setup guides: Authorize HubSpot
Record the fields each system can update, the first-load cutoff, both record IDs, the expected update delay, and who handles errors. Complete the tests before production before expanding to more records.
Use the BigQuery and HubSpot planning worksheet to capture these decisions. Record the access owner in the worksheet and enter credentials only in the connection setup.
Keep each record tied to its source ID. Use the references below to choose field owners and preserve relationships between records.
Download the mapping worksheet · CSV, no email required
Reporting dataset
Plan a company dataset while preserving its source meaning.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Fields to include
References: HubSpot: Company documentation
Reporting dataset
Plan a contact dataset while preserving its source meaning.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Fields to include
References: HubSpot: Contact documentation
Reporting dataset
Plan a deal or opportunity dataset while preserving its source meaning.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Fields to include
References: HubSpot: Deal documentation
Reporting dataset
Plan a support case or ticket dataset while preserving its source meaning.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Fields to include
References: HubSpot: Ticket documentation
Reporting dataset
Plan a product or catalog item dataset while preserving its source meaning.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Fields to include
References: HubSpot: Product documentation
Reporting dataset
Plan a customer invoice dataset while preserving its source meaning.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Fields to include
References: HubSpot: Invoices documentation
Use BigQuery Proposed company table in BigQuery (choose its name) and HubSpot Company for the first pilot. Verify its identity and permitted direction, then add dependent records only when the acceptance checks pass.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Starting event: A change to the selected Proposed company table in BigQuery (choose its name) or Company record needs a defined result in the other system.
Expected result: Use two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only.
If it fails: Repair the cross-system ID relationship before retrying dependent records; do not merge companies solely to remove a sync error.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Starting event: A change to the selected Proposed contact table in BigQuery (choose its name) or Contact record needs a defined result in the other system.
Expected result: Test an email change, two records sharing an email, and a person associated with multiple organizations.
If it fails: Hold ambiguous matches for review and reconcile the person ID before retrying; preserve the consent decision already recorded by its owner.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
Starting event: A change to the selected Proposed deal or opportunity table in BigQuery (choose its name) or Deal record needs a defined result in the other system.
Expected result: Test a reopened won deal, a stage with no destination equivalent, and an amount using a different currency.
If it fails: Suspend downstream creation for a rejected deal and review whether an order already exists before retrying.
Validate the selected objects and operations even where connector-level direction is documented.
Starting event: A business event involving a selected business dataset needs a defined response involving Contact or Company.
Expected result: An example input has an unambiguous destination and expected result; repeated delivery produces only the intended change.
If it fails: Resolve missing identity or ambiguous business meaning before retrying; route unsupported operations to the implementation owner.
Keep both record IDs with the expected and actual result. Reconcile the same filters and time window in each system.
Use two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only.
The expected company relationship is preserved with no duplicate action or unintended write.
Test an email change, two records sharing an email, and a person associated with multiple organizations.
The expected contact relationship is preserved with no duplicate action or unintended write.
Test a reopened won deal, a stage with no destination equivalent, and an amount using a different currency.
The expected deal or opportunity relationship is preserved with no duplicate action or unintended write.
Test a merged ticket, a private note, a reopened case, and an attachment with restricted access.
The expected support case or ticket relationship is preserved with no duplicate action or unintended write.
Check that each connected account can read and write the chosen objects. Exercise both directions with a test record before enabling production changes.
Only an approved, supported direction and permitted fields are written.
Measure source and destination times for the selected records under normal load and a burst. Reconcile IDs and values using the same filters and cutoff.
The process meets its agreed freshness target and reconciliation has no unexplained differences.
Start with the failed record and the destination error, then inspect the source value, field requirements, and access.
Inspect BigQuery Proposed company table in BigQuery (choose its name) and HubSpot Company, their IDs, and the destination error.
Repair the cross-system ID relationship before retrying dependent records; do not merge companies solely to remove a sync error.
Inspect BigQuery Proposed contact table in BigQuery (choose its name) and HubSpot Contact, their IDs, and the destination error.
Hold ambiguous matches for review and reconcile the person ID before retrying; preserve the consent decision already recorded by its owner.
Inspect BigQuery Proposed deal or opportunity table in BigQuery (choose its name) and HubSpot Deal, their IDs, and the destination error.
Suspend downstream creation for a rejected deal and review whether an order already exists before retrying.
Check the BigQuery and HubSpot connector guides, account permissions, and any operations marked On Request.
Ask the integration team to confirm a supported way to handle that record. Verify whether it needs connector configuration or a separate workflow step.
Compare current source values, destination validation, identity mappings, and any side effects already completed.
Stacksync issue retry reads the current source state. Decide the intended state before retrying or reverting; reconcile downstream effects separately.
Read the Stacksync issues dashboard guide for retry and revert behavior.
See how each system detects changes and which updates the other system can receive. Each direction has its own permissions and record requirements.
Detect changesThe setup provisions notification services using Eventarc and Cloud Run in the customer Google Cloud project.
Apply updatesSelected writable fields update in HubSpot. Its permissions and validation rules still apply; rejected records can be inspected in the Issues dashboard.
Detect changesRecord updates and association changes need separate validation. Association detection uses full scans unless Associations CDC Boost is configured for an eligible account.
Apply updatesSelected writable fields update in BigQuery. Its permissions and validation rules still apply; rejected records can be inspected in the Issues dashboard.
Stacksync connects BigQuery and HubSpot with two-way sync for supported records. Authorize the accounts, select the record types, and map compatible fields. Both connectors support reading and writing; object permissions determine the available fields. Use the Issues dashboard to inspect and resolve rejected updates.
Stacksync supports two-way sync between writable records in both systems. The chosen objects and fields must permit updates in both directions. Read-only fields can supply values but cannot receive updates. Stacksync can read database views; it does not write back to the view.
Prepare both accounts, the selected object schemas, stable source and destination IDs, and the expected outcome. Enable BigQuery, Cloud Run, Cloud Resource Manager, and Eventarc APIs in the target project. Have a HubSpot Super Admin authorize Stacksync through the account connection flow. Use the pair worksheet to record ownership and acceptance criteria.
Measure initial-load and ongoing-change latency separately. Source detection, selected objects, account limits, and destination validation determine the observed delay.
No. Stacksync documents that pre-existing duplicates are not merged automatically when two-way sync begins. Review the initial dataset and matching plan before enabling it; an empty destination can simplify the first load.
Start with one business entity and a stable record ID. Map a small set of editable fields with compatible types, test required values and relationships, then expand after the pilot passes.
Check the destination error, field constraints, permissions, and current source value. The Stacksync issues dashboard supports retry and revert; retry reads current source values, so verify the intended record state before acting.
Use the current Stacksync pricing page and confirm the supported implementation with the team. Scope the required objects, record volume, update frequency, initial load, and support needs when comparing a managed connector with native or custom development.
Start by reviewing Proposed company table in BigQuery (choose its name) in BigQuery and Company in HubSpot. Check how these records relate in your workflow, then confirm the actual fields and supported operations. Test record matching and one failed or repeated update before adding more records.
Use BigQuery Proposed company table in BigQuery (choose its name) and HubSpot Company for the first pilot. Verify its identity and permitted direction, then add dependent records only when the acceptance checks pass.
Next step
Walk through your BigQuery and HubSpot records, field mappings, and requirements with an integration engineer.