How to Connect Thrico to Odoo CRM
Step-by-step administrator guide to integrate Odoo 19 (Cloud, Odoo.sh, and Self-Hosted) with Thrico via the JSON-2 External API and API Keys.
The Thrico-Odoo integration connects your Odoo ERP and CRM modules (res.partner, crm.lead, res.company) directly with your Thrico community directory using Odoo's secure JSON-2 External API.
🌟 Overview
Connecting Odoo to Thrico allows automatic synchronization of customer and partner accounts, custom field mapping, and rule-based community membership.
Key Capabilities:
- ⚡ Direct API Key Authentication: No complex OAuth redirect flows required—connect in seconds using a Developer API Key.
- 🔄 Odoo 19 JSON-2 RPC Support: Native support for Odoo 19 Cloud SaaS, Odoo.sh, and self-hosted instances.
- 🏷️ Dynamic Model & Field Discovery: Automatically indexes contacts, companies, leads, and custom
x_*attributes. - 🛡️ Encrypted Credential Storage: API Keys are encrypted at rest using AES-256 GCM.
📋 Prerequisites
Before connecting, make sure you have:
- An Odoo 19 / 18 instance (e.g.
https://yourcompany.odoo.comor custom domain). - An active Odoo User Account with Administrator or CRM access permissions.
- Access to your Thrico Admin Dashboard (
https://admin.thrico.app).
🚀 Step-by-Step Connection Guide
Step 1: Generate a Developer API Key in Odoo
- Log in to your Odoo instance (e.g.
https://yourcompany.odoo.com). - Click your User Avatar / Profile Name in the top-right header → select Preferences (or My Profile).
- Switch to the Account Security tab.
- In the Developer API Keys section, click
[ New API Key ]. - In the confirmation dialog:
- Key Description:
Thrico CRM Integration - Enter your Odoo account login password to authorize key generation.
- Key Description:
- Click Generate Key.
- 🔑 Copy the generated API Key (e.g.
2a6f8b9e...).
Odoo only displays the API Key once. Copy and save it securely. Do NOT use your regular login password in place of the API Key.
Step 2: Find Your Database Name
Your database name is simply your subdomain:
- If your URL is
https://acmecorp.odoo.com, your database name is:
Step 3: Connect from the Thrico Admin Dashboard
- Open your Thrico Dashboard → navigate to:
- Locate the Odoo CRM card and click
Connect Odoo. - In the connection dialog, enter:
- Instance URL:
https://yourcompany.odoo.com - Database Name:
yourcompany - API Key:
<PASTE_YOUR_DEVELOPER_API_KEY>
- Instance URL:
- Click
Test & Connect. - Thrico will validate the credentials against Odoo's JSON-2 endpoint, discover models (
res.partner,crm.lead), and mark the card as CONNECTED.
⚙️ Post-Connection Setup
1. Model & Field Mapping
- Navigate to the Field Mapping tab:
- Default primary object:
Contact / Customer (res.partner). - Map Odoo standard fields (
name,email,phone,parent_id,function) and custom attributes (x_membership_tier,x_points) to Thrico member profiles.
- Default primary object:
2. Initial Data Import
- On the Sync & History tab, click
⚡ Sync Nowto trigger the initial bulk import of all existing Odoo partners into your community.
3. Real-Time Webhook Notification (Optional)
To stream new Odoo contacts instantaneously into Thrico:
- In Odoo → Settings → activate Developer Mode.
- Go to Technical → Automation → Automated Actions.
- Create a rule for
res.partneron Record Creation & Update with action Send Webhook to:
🔒 Security & Data Specifications
| Feature | Standard / Specification |
|---|---|
| API Protocol | Odoo 19 REST JSON-2 RPC (/json/2/<model>/<method>) |
| Authentication | Bearer Token (Developer API Key) |
| Transport | TLS 1.3 End-to-End Encryption |
| Storage Security | AES-256 GCM Encrypted Credentials |