Skip to Content
Odoo Menu
  • Sign in
  • Try it free
  • Apps
    Finance
    • Accounting
    • Invoicing
    • Expenses
    • Spreadsheet (BI)
    • Documents
    • Sign
    Sales
    • CRM
    • Sales
    • POS Shop
    • POS Restaurant
    • Subscriptions
    • Rental
    Websites
    • Website Builder
    • eCommerce
    • Blog
    • Forum
    • Live Chat
    • eLearning
    Supply Chain
    • Inventory
    • Manufacturing
    • PLM
    • Purchase
    • Maintenance
    • Quality
    Human Resources
    • Employees
    • Recruitment
    • Time Off
    • Appraisals
    • Referrals
    • Fleet
    Marketing
    • Social Marketing
    • Email Marketing
    • SMS Marketing
    • Events
    • Marketing Automation
    • Surveys
    Services
    • Project
    • Timesheets
    • Field Service
    • Helpdesk
    • Planning
    • Appointments
    Productivity
    • Discuss
    • Approvals
    • IoT
    • VoIP
    • Knowledge
    • WhatsApp
    Third party apps Odoo Studio Odoo Cloud Platform
  • Industries
    Retail
    • Book Store
    • Clothing Store
    • Furniture Store
    • Grocery Store
    • Hardware Store
    • Toy Store
    Food & Hospitality
    • Bar and Pub
    • Restaurant
    • Fast Food
    • Guest House
    • Beverage Distributor
    • Hotel
    Real Estate
    • Real Estate Agency
    • Architecture Firm
    • Construction
    • Property Management
    • Gardening
    • Property Owner Association
    Consulting
    • Accounting Firm
    • Odoo Partner
    • Marketing Agency
    • Law firm
    • Talent Acquisition
    • Audit & Certification
    Manufacturing
    • Textile
    • Metal
    • Furnitures
    • Food
    • Brewery
    • Corporate Gifts
    Health & Fitness
    • Sports Club
    • Eyewear Store
    • Fitness Center
    • Wellness Practitioners
    • Pharmacy
    • Hair Salon
    Trades
    • Handyman
    • IT Hardware & Support
    • Solar Energy Systems
    • Shoe Maker
    • Cleaning Services
    • HVAC Services
    Others
    • Nonprofit Organization
    • Environmental Agency
    • Billboard Rental
    • Photography
    • Bike Leasing
    • Software Reseller
    Browse all Industries
  • Community
    Learn
    • Tutorials
    • Documentation
    • Certifications
    • Training
    • Blog
    • Podcast
    Empower Education
    • Education Program
    • Scale Up! Business Game
    • Visit Odoo
    Get the Software
    • Download
    • Compare Editions
    • Releases
    Collaborate
    • Github
    • Forum
    • Events
    • Translations
    • Become a Partner
    • Services for Partners
    • Register your Accounting Firm
    Get Services
    • Find a Partner
    • Find an Accountant
      • Get a Tailored Demo
    • Implementation Services
    • Customer References
    • Support
    • Upgrades
    Github Youtube Twitter Linkedin Instagram Facebook Spotify
    +32 2 290 34 90
    • Get a Tailored Demo
  • Pricing
  • Help
  1. APPS
  2. Hubspot
  3. Advance Odoo Hubspot Integration v 15.0
  4. Sales Conditions FAQ

Advance Odoo Hubspot Integration

by echoBitz IT Solutions Pvt. Ltd. https://www.echobitzit.com
Odoo

$ 349.00

v 15.0 Third Party 19
Live Preview
Apps purchases are linked to your Odoo account, please sign in or sign up first.
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • CRM (crm)
• Contacts (contacts)
• Discuss (mail)
• Invoicing (account)
• Sales (sale_management)
• Calendar (calendar)
Lines of code 14427
Technical Name oh_integration
LicenseOPL-1
Websitehttps://www.echobitzit.com
Versions 15.0 16.0 17.0 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • CRM (crm)
• Contacts (contacts)
• Discuss (mail)
• Invoicing (account)
• Sales (sale_management)
• Calendar (calendar)
Lines of code 14427
Technical Name oh_integration
LicenseOPL-1
Websitehttps://www.echobitzit.com
Versions 15.0 16.0 17.0 18.0 19.0
  • Description
  • Documentation
  • License
echoBitz Odoo Partner

Advance Odoo HubSpot
Integration

The Ultimate Bi-Directional Odoo ↔ HubSpot CRM Connector

Transform how your sales and accounting teams collaborate by merging Odoo and HubSpot into a single source of truth. Our Advance integration eliminates manual data entry and third-party middleware bottlenecks by delivering seamless, fully automated, bi-directional synchronization across 6 major modules: Contacts, Companies, Deals, Quotes, Products, and Users.

Configure complex data logic in minutes without a developer. The connector features an intuitive visual dynamic field mapping engine, intelligent dropdown value alignment, hash-based change detection, full HubSpot REST API v3 coverage at every layer and per-field sync direction control (Odoo → HubSpot, HubSpot → Odoo, or both). Powered by flexible triggering - choose between instant manual sync or scheduled background cron batches - your data stays fresh 24/7. Complete with a comprehensive real-time diagnostic logger, you'll have complete visibility and control over every synchronized record.

Why Teams Choose HubSpot Integration

1
Automated Bi-Directional Sync
Eliminate dual-entry. Odoo changes flow to HubSpot automatically; HubSpot deals and contacts trigger accurate Odoo records with no manual intervention.
2
Visual Field Mapping Engine
No coding required. Map Odoo fields to HubSpot properties, set sync direction per field, and align dropdown values visually.
3
Auto-Create HubSpot Custom Fields
One-click creation of all required HubSpot custom properties (odoo_id, sync_odoo) across all 6 object types - no manual HubSpot setup or developer needed.

Business Value It Delivers

A
Single Source of Truth
Bridge the gap between HubSpot CRM and Odoo ERP. Sales, Finance, and Support teams always share identical, up-to-date data - no more conflicting spreadsheets or duplicate records.
B
Robust Auditing & Diagnostics
Never lose a record. Every sync operation - whether manual, scheduled, or webhook-triggered - is logged in real-time with direction, HTTP status, request payload, and resolution status.
C
No Middleware Fees
Why pay monthly for Zapier or Make.com? Connect directly to HubSpot's official REST API v3 - unparalleled speed, reliability, and zero recurring connector costs.
6 Sync Modules
Contacts, Companies, Deals, Quotes, Products, and Users - all synchronized bi-directionally
Visual Field Mapping Engine
OWL-powered drag-and-drop widget maps Odoo fields to HubSpot properties with per-field sync direction control.
Hash-Based Change Detection
Records are only synced when data actually changes - SHA hash comparison eliminates all redundant HubSpot API calls.
Real-Time Diagnostic Logger
Every sync logged with direction, module, HTTP status, request/response payload, and resolution status.

Key Features

Everything you need to connect Odoo and HubSpot securely and automatically

Visual Dynamic Field Mapping
No code required
Hot Feature

Our Visual Dynamic Field Mapping interface to map any Odoo field to any HubSpot property - for every module independently. Set the sync direction per field (Odoo → HubSpot, HubSpot → Odoo, or both). Dropdown value alignment lets you map Odoo selection values to HubSpot picklist keys in a visual matrix.

Per-Field Sync Direction Hot Feature
Each mapped field can be set to sync Odoo → HubSpot, HubSpot → Odoo, or both independently per module.
Dropdown Value Aligner Hot Feature
Map Odoo selection field values to HubSpot enum values visually. Stage names, priorities, and statuses aligned with no code.
Smart Batch Processing
Hot Feature

Configurable pagination size (1–100 records/batch) controls HubSpot API throughput. Records are batched and committed in bulk for maximum efficiency during large sync operations.

Hash-Based Change Detection
Records are compared via SHA hash before syncing. Only changed records are pushed - eliminating all redundant HubSpot API calls.
Configurable Batch Size
Set pagination size 1–100 on the instance. Large batches improve throughput; smaller batches improve error isolation per record.
Auto-Create HubSpot Fields
Hot Feature

One-click creation of all required HubSpot custom properties (odoo_id, sync_odoo) across 6 object types: Contacts, Companies, Deals, Products, Quotes. Skips already-existing fields gracefully.

Import HubSpot Field Schemas
Hot Feature

Fetch all available HubSpot properties for each object type directly into Odoo with a single button click per module. Field names and types are stored and made available in the mapping widget automatically.

HubSpot Webhook Listener
Hot Feature

Receives real-time HubSpot deletion events (contacts, companies, deals, products) via a secure authenticated webhook endpoint. Secret key validation prevents unauthorized calls and instantly mirrors deletions in Odoo.

Flexible Sync Triggering
Choose between: Manual Button per module, Manual HTO Wizard by HubSpot ID, or Scheduled Cron running every 30 min - all modes coexist on one instance.
Sync Progress Tracking
Visual progress stage field on the instance tracks current scheduler state: Users → Contacts → Companies → Deals → Products → Quotes → Completed.
Comprehensive Integration Logger
Hot Feature
Every sync logged: direction, module, record ID, HTTP status, request & response payload, operation type, performed by (Manual/Cron/Webhook), and resolution status.
Delete Propagation
Configurable per module: when a record is deleted in Odoo it is optionally deleted in HubSpot (OTH), and vice versa via webhooks (HTO). Fully toggleable per module.
HubSpot CRM Explorer
Hot Feature
Browse and inspect any HubSpot object type (Contacts, Companies, Deals, Products, Quotes, Users) directly from within Odoo. Apply filters, view raw field schema, and inspect record details in a dedicated UI.
Manual HTO Wizard
Import specific HubSpot records by ID using the HTO Wizard. Enter one or multiple HubSpot IDs (comma-separated) and trigger an immediate import for Contacts, Companies, Deals, Product, or Users.
Configuration Screenshot 1
Go to HubSpot Settings → General profile.
Quick Setup - 5 Steps

Connect Odoo to HubSpot in Minutes

Enter your HubSpot Private App token, create the custom HubSpot fields with one click, configure your visual field mappings, then enable sync. Your Odoo data flows to HubSpot automatically - and HubSpot data flows back with no coding required.

Watch Demo Video
See the full HubSpot integration setup and live bi-directional sync in action.

What is Advance Odoo HubSpot Integration?

Advance Odoo HubSpot Integration is a native Odoo 19 module that creates a direct, secure, bi-directional data bridge between your Odoo ERP and HubSpot CRM using the HubSpot REST API v3. It eliminates the operational friction of managing two separate systems by keeping all business data perfectly synchronized in real time.

The module provides an intuitive, no-code configuration interface with a visual field mapper, dropdown value aligner, and per-module sync controls - all managed from a single OHI instance record. Sync can be triggered manually, automatically via scheduled cron jobs, or reactively via HubSpot Webhooks for real-time deletions. Every operation is captured by a comprehensive Integration Logger with full payload visibility.

Real Bi-Directional Sync
True two-way sync across 6 modules. Pull records from HubSpot into Odoo and push Odoo updates to HubSpot automatically.
Visual Field Mapper
OWL drag-and-drop widget maps Odoo fields to HubSpot properties and aligns dropdown values - no code required.
Hash-Based Change Detection
Records synced only when data actually changes via SHA hash comparison - no wasted HubSpot API calls.
Diagnostic Logger
Every sync logged with direction, module, HTTP status, request/response payload, and resolution status.

6 Synchronized Modules

Complete coverage across your entire business workflow - from CRM to Finance

👤
Contacts
↔ Both
Sync individual contacts (people) between res.partner and HubSpot Contacts object. Includes first/last name split, email-based deduplication, and related activity sync.
  • Email deduplication check before create
  • Sync related Notes, Tasks, Emails, Meetings
  • Sync associated Companies & Deals
  • HubSpot owner auto-linked to Odoo user
🏢
Companies
↔ Both
Sync company records (res.partner where is_company=True) to HubSpot Companies object, including all associated contacts and deals.
  • Auto-detect company vs contact records
  • Sync related Contacts & Opportunities
  • Notes, Tasks, Emails, Meetings, Attachments
  • Delete in HubSpot when deleted in Odoo
💼
Deals
↔ Both
Sync CRM Opportunities (crm.lead) to HubSpot Deals. Probability is auto-converted to HubSpot deal stage probability format.
  • Stage & pipeline mapping with dropdown aligner
  • Probability % auto-converted
  • Sync related Notes, Tasks, Emails, Meetings
  • Linked to Contacts & Companies in HubSpot
📄
Quotes
↔ Both
Sync Sale Orders (sale.order) as HubSpot Quotes. Supports both HubSpot template types and auto-associates quotes with the correct quote template.
  • CUSTOMIZABLE_QUOTE_TEMPLATE & CPQ_QUOTE
  • Auto-link to HubSpot Quote Template
  • Line items synced with product association
  • Linked to Deals in HubSpot
📦
Products
↔ Both
Sync product.template records to HubSpot Product Library. Internal reference (default_code) is used for deduplication in HubSpot.
  • Internal reference deduplication
  • Price, description, and category mapping
  • Delete propagation to HubSpot product library
  • Used as line items in Quote sync
👥
Users
↔ Both
Sync Odoo internal users (res.users) to HubSpot Users and retrieve HubSpot Owner IDs for record ownership linking across all modules.
  • First name / last name field split
  • Email used as match key in HubSpot
  • HubSpot Owner ID stored on Odoo user
  • Auto-assigned as deal/contact owner

How to Set Up HubSpot Integration

Follow these steps to go from installation to live bi-directional sync with HubSpot.

1 Install & Configure the Instance
  1. Go to HubSpot Integration → Instance in Odoo
  2. Click New and give the instance a name
  3. Enter your HubSpot Private App Access Token
  4. Set your HubSpot Domain, Default Odoo User, and Pagination Size
  5. Click Test Connection to verify your token is valid
  6. Only one instance can be active at a time - enforced automatically
2 Create HubSpot Custom Fields
  1. On your OHI Instance, click Create HubSpot Custom Fields
  2. This auto-creates odoo_id and sync_odoo on all HubSpot object types
  3. Fields that already exist in HubSpot are skipped gracefully
  4. Covers: Contacts, Companies, Deals, Products, Quotes
  5. No manual HubSpot setup or developer access needed
  6. Confirm success in the notification banner
3 Import HubSpot Field Schemas
  1. For each module tab (Contacts, Companies, Deals, etc.), click Import Fields
  2. All HubSpot property definitions are fetched and stored in Odoo automatically
  3. Standard and custom HubSpot properties are both imported
  4. Fields become immediately available in the visual field mapping widget
  5. Repeat for each module you intend to sync
4 Map Fields & Align Dropdown Values
  1. Open each module tab and use the drag-and-drop Field Mapper
  2. Link each Odoo field to its corresponding HubSpot property
  3. Set the Sync Direction per field: OTH, HTO, or Both
  4. Use the Dropdown Value Aligner for selection/picklist fields
  5. Map Odoo stage names, priorities, and statuses to HubSpot enum values
  6. Save the instance record when all mappings are complete
5 Enable & Sync

Enable sync checkboxes per module (OTH and/or HTO). Click Sync Now manually for an immediate sync, or let the Scheduled Cron run every 30 minutes automatically. Monitor all operations in the Integration Logger.

Sync triggers: Manual Button · Scheduled Cron (30 min) · HTO Wizard (by HubSpot ID)
💡 Webhook Setup for Real-Time Deletions

Configure HubSpot to POST deletion events to your Odoo webhook endpoint. Set the Webhook Secret Key on your instance and subscribe to contact, company, deal, and product deletion events in HubSpot Settings.

POST /hubspot/webhook?auth=<your_secret_key>

The auth parameter is validated against the Webhook Secret Key stored on the OHI Instance. Mismatched keys are rejected and logged automatically.

How It Works

From installation to live bi-directional sync between Odoo and HubSpot in four simple steps

1
Install & Connect

Install the module in Odoo 19, enter your HubSpot Private App Access Token, and test the connection with one click.

2
Create HubSpot Fields

Click Create HubSpot Custom Fields to auto-generate odoo_id and sync_odoo on all HubSpot object types instantly.

3
Import Schemas & Map Fields

Import HubSpot field schemas per module, then use the visual mapper to link Odoo fields to HubSpot properties and align dropdown values.

4
Enable & Sync Live

Toggle sync checkboxes per module and click Sync Now, or let the 30-minute scheduled cron keep your data fresh automatically 24/7.

Feature Deep Dive

Explore every capability of the Advance Odoo HubSpot Integration in detail

  • Configuration
  • Token & Security
  • Model Configuration
  • Logs Configuration
  • API & Data Fetch
  • Release Notes
  • FAQ
1
Prerequisites
✅ Odoo Version
Odoo 15+ (Community or Enterprise). The module uses only built-in Odoo framework - no external libraries required.
✅ HubSpot Account
Active HubSpot account (Free, Starter, Professional, or Enterprise). You must have permissions to create a Private App to generate an Access Token.
✅ Admin Access
You need Odoo Administrator rights to install the module and configure the HubSpot connection and field mappings.
2
Install the Module
  1. Go to Odoo → Apps and search for Advance Odoo HubSpot Integration
  2. Click Install - no pip packages or external libraries needed
  3. After installation, a new menu HubSpot Integration appears in the main Odoo menu bar
  4. The menu contains: Instance, Integration Logger, and HubSpot Explorer
3
Configure the OHI Instance
Steps
  1. Go to HubSpot Integration → Instance
  2. Click New and give the instance a name (e.g. Production HubSpot)
  3. Enter your HubSpot Access Token (from your HubSpot Private App)
  4. Set your HubSpot Domain
  5. Set Default Odoo User and Default HubSpot User
  6. Set Pagination Size (1–100) and click Test Connection
  7. Note only one instance can be Active (Connected) at a time
Instance Fields Reference
Name - friendly label for the instance
Access Token - HubSpot Private App token
HubSpot Domain - your HubSpot portal domain
Default Odoo User - fallback for unmatched records
Pagination Size - batch size per API call (1–100)
Webhook Secret Key - validates incoming HubSpot webhook calls
Scheduler Stage - tracks cron progress across all modules
4
Enable Per-Module Sync Settings
  1. Open the OHI Instance and navigate to each module tab (Contacts, Companies, Deals, etc.)
  2. Toggle Sync OTH to enable Odoo → HubSpot for that module
  3. Toggle Sync HTO to enable HubSpot → Odoo for that module
  4. Toggle Related Data Sync for Notes, Tasks, Emails, Meetings
  5. Toggle Delete OTH / HTO to enable delete propagation per module
  6. Check the Last Sync Date fields to confirm last successful sync
  7. Click Save - settings take effect on the next manual or scheduled sync
5
Configure Field Mappings
Steps
  1. Click Import Fields on the module tab to fetch HubSpot property schema
  2. In the Field Mapping widget, drag Odoo fields and link them to HubSpot properties
  3. Set the Sync Direction per field: OTH, HTO, or Both
  4. Use the Dropdown Value Aligner for selection/picklist fields
  5. Map Odoo stage names, priorities, and statuses to HubSpot enum values
  6. Set Concept Type to DIMENSION or METRIC for each field
  7. Only mapped fields are included in sync operations
Mapper Models Per Module
ohi.contacts.lines → Contacts (res.partner)
ohi.companies.lines → Companies (res.partner)
ohi.opportunities.lines → Deals (crm.lead)
ohi.quotes.lines → Quotes (sale.order)
ohi.products.lines → Products (product.template)
ohi.users.lines → Users (res.users)
6
Trigger a Manual Sync
  1. Open the OHI Instance record in Odoo
  2. For each module tab, click Sync Now OTH to push Odoo → HubSpot
  3. Click Sync Now HTO to pull HubSpot → Odoo
  4. Use the HTO Wizard to import specific records by HubSpot ID
  5. Click Open Scheduler to configure or run the automated cron job
  6. Monitor all synced records in the Integration Logger
  7. Resolve pending log entries after reviewing error details and payloads
7
Validate & Monitor Your Sync
🔍 Test Connection
Verify your HubSpot Access Token is valid:
Click "Test Connection" on the OHI Instance
A success/error notification confirms the API status
Check the Integration Logger for full request/response details on every sync
📊 Monitor Sync Progress
Track the scheduler stage on the instance:
Users OTH → Users HTO → Contacts OTH → Contacts HTO → Companies → Deals → Products → Quotes → Completed
The Last Sync Date per module is updated after each successful run.
Last HubSpot ID acts as a pagination cursor for HTO syncs.
📋 Integration Logger
Every sync operation is logged under HubSpot Integration → Integration Logger. Check the direction, HTTP status, request/response payload, and resolve pending errors. Auto-purged by configurable retention schedule.
Configuration Screenshots
Configuration Screenshot 1
Go to HubSpot Settings → General profile.
Configuration Screenshot 2
Go to Settings → Integrations → Legacy Apps.
Configuration Screenshot 3
Click on “Create legacy app” and select Private app.
Configuration Screenshot 4
Enter app name, logo, and description in Basic Info.
Configuration Screenshot 5
Go to Scopes tab and click “Add new scope.”
Configuration Screenshot 6
Add required scopes and save them.
Configuration Screenshot 7
Go to Webhooks tab and configure event subscriptions.
Configuration Screenshot 8
Go to Auth tab and copy the Access Token.
Configuration Screenshot 9
Go to Settings and search “Domain Manager.”
Configuration Screenshot 10
Open Domain Manager and copy the system domain.
Configuration Screenshot 11
Open Odoo and click on HubSpot Integration app.
Configuration Screenshot 12
Click “New” to create a HubSpot instance in Odoo.
Configuration Screenshot 13
Enter Access Token, Domain, and select default users.
Configuration Screenshot 14
Click “Test HubSpot API Connection” to verify connection.
Configuration Screenshot 15
Click “Create HubSpot Custom Fields” and check logs in HubSpot Logger.

HubSpot Access Token & Security

The integration authenticates with HubSpot via a Private App Access Token stored securely on the OHI Instance. Your token is used as a Bearer token on every HubSpot API v3 request. Only one instance can be active at a time, enforced by a SQL constraint and Python validation.

HubSpot API Coverage
  • CRM Objects API v3 (Contacts, Companies, Deals, Products, Quotes)
  • Settings API v3 (Users, Owners)
  • Properties API v3 (field schema import)
Webhook Security
  • Incoming webhooks validated via Secret Key in URL param
  • Mismatched keys are logged and rejected instantly
  • Per-module delete enable flags control which events are processed
  • All operations logged with full payload visibility
Single Active Instance Constraint

Only one OHI Instance can be Active (Connected) at a time. This is enforced by a SQL UNIQUE constraint on the database and a Python validation method - preventing conflicting sync jobs or accidental dual-writes.

How OTH Sync Works (Odoo → HubSpot)
  1. Fetch Odoo records newer than the last sync date from ohi.records
  2. Compute SHA hash of all mapped field values for each record
  3. Compare hash against stored odoo_hash - skip unchanged records
  4. Search HubSpot for existing record by odoo_id property
  5. Create (POST) or Update (PATCH) via HubSpot batch API
  6. Write-back HubSpot ID and new hash to the Odoo record
  7. Log result with full request/response payload to ohi.logger
Webhook Endpoint
POST /hubspot/webhook?auth=<secret_key>
Content-Type: application/json

[ { "subscriptionType": "contact.deletion", "objectId": 12345 } ]

Field Mapping Configuration

Each module has its own mapper model that stores field-to-field relationships between Odoo and HubSpot. The OWL drag-and-drop widget makes configuration intuitive - no developer needed.

Field Mapping Line Attributes
  • Odoo Field - technical field name on the Odoo model
  • Odoo Field Type - auto-fetched (char, many2one, etc.)
  • HubSpot Property - corresponding HubSpot field name
  • HubSpot Field Type - HubSpot data type (string, number)
  • Sync Direction - OTH, HTO, or Both
Dropdown Value Mapping

A JSON field stores the value translation matrix for selection/enum fields. The OWL widget renders it as an interactive key-value grid for visual alignment.

{ "draft": "DRAFT", "sale": "CLOSED_WON",
 "cancel": "CLOSED_LOST" }
Supported Sync Modules

All 6 modules have independent mapper models. Each module's field mappings, sync direction, and dropdown alignments are fully configured separately.

Sync Module Overview
Contacts Companies Deals Quotes Products Users
Model Configuration Screenshots
Model Configuration Screenshot 1
Go to Opportunities tab and click on “Import Opportunities Fields.”
Model Configuration Screenshot 1
Map Odoo stage_id with HubSpot dealstage and verify field mappings.

Integration Logger

Every sync operation - whether triggered manually, by cron, or by webhook - is captured in the ohi.logger model. The logger provides a full audit trail with enough detail to diagnose and resolve any data sync issue.

Logger Fields Captured
  • Integration Direction - Odoo To HubSpot / HubSpot To Odoo
  • Module Name - Contacts, Companies, Deals, etc.
  • Operation - Create / Update / Delete / Import Fields
  • Record ID - Odoo record ID processed
  • Status Code - HTTP response code from HubSpot
  • Request & Response Payload - full JSON data
  • Resolution Status - Pending / Resolved
  • Performed By - Manually / Scheduler / Webhooks

Integration Logger Fields

Every sync operation is automatically logged. Browse the full history from HubSpot Integration → Integration Logger.

Fields Captured per Sync
Direction Odoo To HubSpot / HubSpot To Odoo
Module Contacts, Deals, etc.
Operation Create / Update / Delete
Record ID Odoo record processed
HTTP Status 200 / 400 / 404 / 500
Request Payload Data sent to HubSpot
Response Payload HubSpot API response
Performed By Manual / Scheduler / Webhook
Resolution Status Pending / Resolved
Log Retention
  • Remove Log Scheduler — configurable 1–12 month retention
  • Scheduled Sync Cron — runs every 30 min automatically
Log Type Reference

Each log entry is classified by type to make filtering and diagnosis instant. Resolve pending entries after fixing any errors.

Log Type Meaning Resolution
Success Sync completed successfully Auto-Resolved
Error API call failed with error Pending → Manual
Warning Partial or non-critical issue Review & Resolve
Info Informational operation log Auto-Resolved
Log Configuration Screenshots
Log Configuration Screenshot 1
Go to HubSpot Logger and verify sync status, logs, and errors for data transfer.

HubSpot API Endpoints Used

HubSpot API Purpose
POST /crm/v3/objects/<type>/batch/create Bulk create new records
POST /crm/v3/objects/<type>/batch/update Bulk update existing records
POST /crm/v3/objects/<type>/search Search by odoo_id property
DELETE /crm/v3/objects/<type>/<id> Delete record from HubSpot
GET /crm/v3/properties/<type> Import field schema
POST /crm/v3/properties/<type> Create custom properties
GET /settings/v3/users Fetch HubSpot users/owners
POST /hubspot/webhook Receive deletion events
Sync Engine Architecture & Data Flow
Three-Layer Architecture
  • ohi.records — orchestration layer
  • ohi.methods — per-module processing
  • ohi.utils — HubSpot API calls & write-backs
HTO Sync Response
Fetch HubSpot records paginated
 → Apply mapped fields to Odoo
 → Create or update Odoo record
 → Store hubspot_id on Odoo
 → Log success or error
Scheduler Sequence
  • Users OTH → Users HTO
  • Contacts OTH → Contacts HTO
  • Companies → Deals → Products
  • Quotes → Completed

Release Notes & Version History

Version 19.0.13.0.0
Latest
  • HubSpot Playground: Added Response Payload visualization tab to the Explorer Playground.
  • UI/UX: Polished interactive Explorer badge alignments and Dropdown Mapper header elements.

Version 19.0.12.0.0
  • API Fetch Explorer: Extended robust support and queries for HubSpot CMS Domains and Currencies endpoints.
  • Documentation formatting and layout adjustments for standard wider screens.

Version 19.0.11.0.0
  • Sync Architecture: Implemented bi-directional synchronization parameters for record Associations via v4 API.
  • Mapper Widget: Added fully dynamic multi-directional attribute mapping rules interface via OWL framework.

Version 19.0.10.0.0
  • Diagnostic Layer: Enhanced and activated robust logging with direct raw JSON request and response inspection capabilities.

Version 19.0.9.0.0
  • Configuration UI: Visual Drag & Drop configuration mapping interface component successfully introduced.
  • Properties Schema: Upgraded custom properties runtime import schema extraction capability.

Version 19.0.8.0.0
  • Performance Scale: Implemented multi-threaded batch sync operations for significantly faster CRM queue ingestion.

Version 19.0.7.0.0
  • Event Bus: Integrated complete webhook listening for real-time CRM hard-deletion synchronizations.

Version 19.0.6.0.0
  • Quotes Module: Expanding primary connector engine to fully synchronize Quotes and HubSpot Support objects.


Version 19.0.4.0.0
  • Sales Cycle:Minor bug fixed.

Version 19.0.3.0.0
  • Companies: Minor bug fixed.

Version 19.0.2.0.0
  • Security Framework: Advanced Record Rules and security Access Control List (ACL) enhancements deployed for distinct module user profiles.

Version 19.0.1.0.0 — Initial Release
  • Base Integration System: Official launch with bi-directional Contacts & Internal Users integrations topology setup.
  • Core Engine: High-performance, zero-middleware hub architecture established.
Frequently Asked Questions
Can I have multiple HubSpot instances connected at once?
No. Only one OHI Instance can be Active (Connected) at a time - enforced by a SQL UNIQUE constraint and Python validation. This ensures data consistency and prevents conflicting sync jobs.
Will duplicate records be created if I run sync multiple times?
No. The sync engine uses odoo_id as the unique identifier in HubSpot. Before creating any record, it searches for an existing one by odoo_id and updates it. For Contacts, email address is also used as a deduplication key.
What happens if a sync fails mid-way?
Every record operation is individually logged. If one record fails, the rest continue processing. Failed operations appear as Pending in the Integration Logger with full error details and payloads for investigation and manual resolution.
Can I map custom HubSpot properties?
Yes. After clicking Import Fields, all HubSpot properties - including custom ones - are available in the visual mapper. You can also create new custom HubSpot properties directly from Odoo using the Create HubSpot Custom Fields button.
What Odoo version is required?
The module is built and tested on Odoo 19 (Community and Enterprise). Required dependencies: helpdesk, mail, crm, sale_management, account, base_automation, and bus.
Does this module require external libraries or middleware?
No. Uses only Odoo 19's built-in framework and Python's standard library (json, hashlib, requests). No Zapier, Make.com, or any third-party middleware required - direct HubSpot API v3 connection only.

Book a Demo or Watch Advance Odoo HubSpot Integration in Action

Schedule a walkthrough with our team or explore the HubSpot integration demo video.

Watch Demo Video
See the full Advance Odoo HubSpot Integration setup, live bi-directional sync, and field mapping workflow in action.
Schedule a Meeting
Talk to echoBitz about your use case, rollout plan, and the best HubSpot Integration setup for your Odoo project.

Scan and Connect with echoBitz

Book a meeting, start a WhatsApp conversation, or reach us by email from one simple visual card. It is the fastest way to move from curiosity to a live HubSpot Integration discussion.

Meeting WhatsApp Email
echoBitz QR contact options

Our Services

Odoo Integration

Seamlessly integrate Odoo with third-party apps, platforms, and tools for better workflow.

Odoo Implementation

We plan, configure, and deploy Odoo tailored to your business processes.

Customization

Get modules and workflows customized to meet your exact needs in Odoo.

Community Apps

Access or develop robust community apps to enhance your Odoo functionality.

Development Outsourcing

Hire dedicated Odoo developers to build solutions efficiently and cost-effectively.

Support & Maintenance

Enjoy peace of mind with our reliable support, updates, and bug fixing services.

Discover More Solutions by echoBitz IT

Explore our other Odoo integration apps

Odoo Xero Integration
Odoo Xero Integration

Sync contacts, users, Quotes, and many more form sync both way.

Odoo Zoho CRM Integration
Odoo Zoho CRM Integration

Bidirectional sync of leads, contacts, accounts, and activities with Zoho CRM.

Odoo HubSpot Integration
Odoo HubSpot Integration

Connect contacts, companies, deals, and marketing workflows between HubSpot and Odoo.

Odoo Zendesk Integration
Odoo Zendesk Integration

Sync Zendesk tickets, customers, and organizations with Odoo Helpdesk and contacts.

Odoo Office 365 Integration
Odoo Office 365 Integration

Connect calendar, contacts, tasks, and emails with Microsoft 365 services.

Odoo WooCommerce Integration
Odoo WooCommerce Integration

Bidirectional sync of products, orders, customers, inventory, and payments.

View All echoBitz Apps on Odoo App Store

Ready to connect your Odoo and HubSpot with Advance Odoo HubSpot Integration?

Install the Advance Odoo HubSpot Integration, enter your HubSpot Private App token, and start syncing Contacts, Companies, Deals, Quotes, Products, and Users bi-directionally in minutes - no middleware, no manual entry, no code required.

Get Support Schedule a Demo Visit Our Website
echoBitz IT Solution Pvt. Ltd. | Odoo Certified Partner | info@echobitzit.com | www.echobitzit.com

A Powerful Integration App for Odoo and HubSpot

Odoo Hubspot Integration is an innovative integration app that bridges the gap between two industry-leading platforms, Odoo and HubSpot. With its advanced features and intuitive design, it empowers businesses to automate lead synchronization, establish a two-way data flow, facilitate real-time updates, streamline workflows, and eliminate the need for manual synchronization. By Odoo Hubspot Integration integrating these two powerful systems, Odoo Hubspot Integration offers unparalleled efficiency and productivity, allowing businesses to focus on what matters most—growing their customer base and driving revenue.

Installation

  1. Prerequisites
    • Python 3.7 or later
    • Odoo 15.0 or later
    • Sales Module, CRM Module, Invoicing Module
    • we need to create 8 additional fields into hubspot.
      1. Contacts :
        • odoo_id(Single-line text) (This field will contain odoo record id. it Must be Unique)
        • sync_odoo(Single checkbox) (This is the checkbox field and based on the selection integration will sync the record from hubspot to odoo)
      2. Companies :
        • odoo_id(Single-line text) (This field will contain odoo record id. it Must be Unique)
        • sync_odoo(Single checkbox) (This is the checkbox field and based on the selection integration will sync the record from hubspot to odoo)
      3. Deals :
        • odoo_id(Single-line text) (This field will contain odoo record id. it Must be Unique)
        • sync_odoo(Single checkbox) (This is the checkbox field and based on the selection integration will sync the record from hubspot to odoo)
      4. Products :
        • odoo_id(Single-line text) (This field will contain odoo record id. it Must be Unique)
        • sync_odoo(Single checkbox) (This is the checkbox field and based on the selection integration will sync the record from hubspot to odoo)
  2. Installation Steps
    Please find reference documents in the module.
    following two documents are there:
    1. Installation Guide(Installation_Guide.pdf)
    2. User Guide(User_guide.pdf)

Credits

Contributors

  • echoBitz IT Solutions Pvt Ltd <info@echobitzit.com>

Author & Maintainer

This module is maintained by the echoBitz IT Solutions Pvt Ltd

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
Community
  • Tutorials
  • Documentation
  • Forum
Open Source
  • Download
  • Github
  • Runbot
  • Translations
Services
  • Odoo.sh Hosting
  • Support
  • Upgrade
  • Custom Developments
  • Education
  • Find an Accountant
  • Find a Partner
  • Become a Partner
About us
  • Our company
  • Brand Assets
  • Contact us
  • Jobs
  • Events
  • Podcast
  • Blog
  • Customers
  • Legal • Privacy
  • Security

Odoo is a suite of open source business apps that cover all your company needs: CRM, eCommerce, accounting, inventory, point of sale, project management, etc.

Odoo's unique value proposition is to be at the same time very easy to use and fully integrated.

Website made with