Functional Walkthrough
See the
Connector in Action
Explore how easy it is to link your tables, map records, manage
dynamic queues, and handle synchronization exceptions.
1. Centralized Airtable Integration Dashboard
Monitor your entire Airtable sync ecosystem from a unified control
panel. The interactive Kanban dashboard provides instant visibility
into active table mappings, pending operations, sync failure queues,
and unresolved data conflicts. Keep track of connector health
parameters, queue distributions, and sync request ratios at a single
glance.
Monitor health stats, mapping coverage, and synchronization queue
ratios.
Dashboard Cards & Buttons:
-
Active Mappings
Displays the count of active Odoo-to-Airtable mappings. Click to
view mapping list.
-
Queue Waiting / Failed
Tracks pending tasks and failed jobs. Click to access the
Operations Queue.
-
Sync All Now
Triggers outbound synchronization processes for all active
configuration mappings.
-
View Logs
Directly navigates to the sync log view grouped by success, error,
and skip state.
2. Secure Connection Profile Setup
Establish secure credentials using Airtable Personal Access Tokens
(PAT) conforming to modern token authentication and OAuth
requirements. Define specific Base IDs, company mappings for
multi-company environments, default sync directions, and rate limiting
thresholds. The built-in Test Connection validator dynamically
checks credentials and scope permissions before activating the
profile.
Manage credentials, tokens, bases, and cache fetched schemas.
Action Buttons:
-
Test Connection
Validate credentials, tokens, and access permissions to confirm
connection to the remote Airtable Base.
-
Fetch All Schemas
Query base structure from Airtable metadata endpoints and populate
Odoo's local schema caches.
-
Auto-Generate Mappings
Scans cached base columns and auto-creates both model and field
mapping layouts.
-
Register Webhook
Registers Odoo callback URL inside Airtable webhook service config
for real-time synchronization.
-
Sync All Now
Enqueues outbound background synchronization jobs for all active
mappings.
3. Airtable Schema Fetch & Auto-generation
Perform automated metadata scans of your remote bases. Fetch the
entire table structure from your Airtable base to populate local
schema caches, mapping out tables and column field types
automatically. You can also auto-create new tables and columns in
Airtable directly from Odoo mapping definitions, avoiding manual
database schema updates on both platforms.
Fetch latest Airtable base changes to quickly map tables and
columns.
Schema Cache Actions:
-
Fetch Schema
Queries Airtable's schema metadata for the selected table to
update Odoo's local cache.
-
Auto-Create Table
Automatically builds a matching new table structure with all
fields directly in the remote Airtable Base.
4. Direct Model to Table Mappings
Define model-level mappings between Odoo standard or custom models
(such as Contacts, Products, or Sales Orders) and remote Airtable
tables. Customize sync directions, configure cron execution batch
sizes, choose write triggers (auto-sync on write), select conflict
resolution policies (Odoo wins, Airtable wins, or manual), and apply
advanced Odoo search domain filters to sync only specific record
subsets.
Configure sync direction (bi-directional, inbound, outbound) and
custom Odoo record filters.
Synchronisation Actions:
-
Sync Outbound Now
Instantly enqueues active Odoo records matching the domain filter
to be pushed to Airtable.
-
Sync Inbound Now
Fetches and processes modifications made in the remote Airtable
table directly into Odoo.
-
Push New Fields
Creates columns in the remote Airtable table for any newly mapped
fields that do not exist yet.
5. Precise Field-Level Mappings
Align individual database columns. Map Odoo fields to corresponding
columns in the cached Airtable schema. The connector handles complex
data types seamlessly: many-to-one relations with customizable mapping
policies (create/ignore/raise), many-to-many fields (comma-separated
or JSON lists), numerical conversions with custom null fallback
policies, and inbound read-only controls.
Define key columns, read-only mappings, and relational mapping
policies.
Mapping Constraints & Settings:
-
Key Field
Marks a field as a unique identifier used to match records between
platforms (prevents duplicates).
-
Inbound Read-Only
Protects Odoo records by preventing remote Airtable updates from
overwriting this field.
6. Airtable Webhooks Subscriptions
Enable instant real-time synchronization, bypassing cron polling
intervals. With webhook integration enabled, Odoo registers a webhook
subscription directly in Airtable under the profile's Base. Any
modifications in Airtable trigger an immediate HTTP POST callback to
Odoo's secure webhook controller, instantly enqueueing a sync job to
keep data unified.
Webhook monitoring showing active payload triggers from Airtable
updates.
Webhook Credentials & Settings:
-
Webhook ID
The unique subscription ID registered in Airtable for tracking
update notification callbacks.
-
HMAC Secret
Cryptographic key used to verify incoming payloads, ensuring
secure callback sources.
7. Asynchronous Queue & Audit Logs
Ensure high-performance background execution with an asynchronous task
queue. Synchronization jobs are enqueued with high, normal, or low
priorities and processed in background worker threads, preventing UI
lockups. Failed tasks automatically back off and retry up to maximum
limits, recording complete request/response payloads, execution
durations, and detailed error tracebacks.
View detailed execution queue jobs, payloads, retries, and failure
stack traces.
Queue Controls:
-
Process Now
Forces immediate synchronous processing of selected pending or
failed jobs in the queue list.
-
Retry Sync
Re-enqueues a failed sync job after correcting any schema or token
settings.
8. Side-by-Side Conflict Resolution
Resolve concurrent changes without data loss. If a record is modified
simultaneously in both Odoo and Airtable, the connector flags a
conflict and puts it in a pending state. A dedicated dashboard
displays the Odoo current values and Airtable incoming values
side-by-side in JSON code editors, allowing users to apply custom
resolutions (Odoo Wins, Airtable Wins, or Manual overrides) with
detailed resolution notes.
Resolve data overlaps using automated rules or human-in-the-loop
decisions.
Resolution Actions:
-
Odoo Wins
Keeps local Odoo data. The record is flagged to push outbound,
overwriting the remote Airtable record on next sync.
-
Airtable Wins
Applies the remote Airtable field values to Odoo and updates the
record in Odoo's database.
-
Manual Resolve
Closes the conflict ledger entries without automatic writes,
allowing custom manual data corrections.