Odoo Integration
EmBoux provides two Odoo modules for zero-code email management:
Modules
Section titled “Modules”EmBoux Core (emboux_core)
Section titled “EmBoux Core (emboux_core)”The universal connector. Install it on any Odoo 19 instance to manage domains, mailboxes, and aliases directly from the Odoo backend.
- Works with both master and client tokens
- Automatic API sync on create/delete
- Split-brain resolution (handles duplicates gracefully)
EmBoux SaaS (emboux_saas)
Section titled “EmBoux SaaS (emboux_saas)”The commercial layer for SaaS platforms. Extends Core with:
- Product plans — Starter, Business, Enterprise with configurable limits
- Customer quotas — Automatic quota management from subscriptions
- Grace periods — 30-day window with email reminders before suspension
- Auto-suspension — Excess domains frozen automatically after grace
- Auto-reactivation — Domains restored when customer pays
- Portal — Customer self-service at
/my/emboux - API Key provisioning — Automatic key generation on first purchase
- Overage billing — Monthly invoice for excess mailboxes/aliases
1. Install the modules
Section titled “1. Install the modules”Upload emboux_core and emboux_saas to your Odoo addons path and install them.
Dependencies:
emboux_core:base,mailemboux_saas:emboux_core,portal,sale,whatsapp
2. Configure API connection
Section titled “2. Configure API connection”Go to Settings > EmBoux and set:
| Field | Value |
|---|---|
| API URL | https://api.emboux.com |
| API Token | Your master token |
3. Create plans (SaaS only)
Section titled “3. Create plans (SaaS only)”Pre-built plans are installed with the module:
| Plan | Price | Domains | Mailboxes | Storage | Retention |
|---|---|---|---|---|---|
| Starter | $9.99 | 1 | 1/domain | 1 GB | 30 days |
| Business | $49.99 | 10 | 5/domain | 2 GB | 60 days |
| Enterprise | $199.99 | Unlimited | 20/domain | 5 GB | 90 days |
You can modify these or create new ones at Sales > Products.
How It Works
Section titled “How It Works”Customer Purchase Flow
Section titled “Customer Purchase Flow”- Customer buys an EmBoux plan via Sale Order
- On SO confirmation:
- Quota record created automatically
- API key provisioned on EmBoux
- Limits synced (domains, mailboxes, storage, retention, transfer)
- Welcome email sent
- Customer visits
/my/embouxto manage their domains
Suspension Flow
Section titled “Suspension Flow”- Customer exceeds domain quota (e.g., creates 6 domains on a 5-domain plan)
- State transitions to
exceeded, grace period starts (30 days) - Email reminders sent at days 7, 15, and 22
- After day 30: excess domains are suspended on EmBoux (LIFO order)
- Customer buys upgrade or addon → domains reactivated automatically
Cron Jobs
Section titled “Cron Jobs”The module installs three automated jobs:
| Job | Interval | Purpose |
|---|---|---|
| Grace Period Check | Daily | Advance grace states, apply suspensions |
| Usage Sync | Every 6 hours | Pull usage data from EmBoux |
| Overage Billing | Monthly | Invoice for excess mailboxes/aliases |
Portal Features
Section titled “Portal Features”Customers can self-manage at /my/emboux:
- View quota status (OK, Grace Period, Suspended)
- Add/delete domains
- Add/delete mailboxes (with password reveal on creation)
- Add/delete aliases
- View and manage API keys
- See usage statistics
Sending Mail from Odoo via EmBoux
Section titled “Sending Mail from Odoo via EmBoux”Any mailbox you create in emboux_core can be used as an Odoo Outgoing Mail Server. The mailbox detail view lists the ready-to-paste SMTP settings under Outgoing Mail Server (SMTP). Two options are offered:
- Option 1 — STARTTLS on port 587.
- Option 2 — SSL/TLS on port 465. Recommended for Odoo and for any client that has trouble with the STARTTLS handshake.
Align mail.catchall.domain with an enabled domain
Section titled “Align mail.catchall.domain with an enabled domain”Odoo builds the technical sender (the envelope sender, also called Return-Path) of every outbound message as bounce@<mail.catchall.domain>, not from the authenticated SMTP user. That domain must be enabled in EmBoux: either the domain of the mailbox you authenticate with, or another domain registered in EmBoux with a sending credential.
Open Settings > Technical > System Parameters and set mail.catchall.domain to that domain. For example, if your outgoing server authenticates as [email protected], set mail.catchall.domain to tenant.example.com.
Since 2026-11-03, ports 587 and 465 reject a technical sender from a domain that is not enabled, at the moment of sending:
553 5.7.1 Sender domain is not enabled to send through EmBoux: use an address of your EmBoux domain as envelope sender (Return-Path)Odoo shows this error on the email. Correct mail.catchall.domain (or the alias domain) and retry the email. Before that date, such emails were accepted and then lost without notice.
On a multi-tenant SaaS, each tenant database should set this parameter to match its own subdomain, so the technical sender is always an enabled domain.
mail.catchall.domain only controls the technical sender. The visible From address is the mailbox address, and Reply-To can stay your own address, so replies reach you directly. See Sending from a subdomain.
Mass mailing: what “sent” means
Section titled “Mass mailing: what “sent” means”In an Odoo mass mailing, sent means the SMTP server accepted the email. It does not mean the email reached the recipient’s inbox. Bounces and spam placement show up afterwards, in the mailing’s bounce statistics in Odoo and in the EmBoux Deliverability Report.
- Odoo (Odoo Online and Odoo.sh) applies its own daily sending limit with its built-in server. For large campaigns, use an external server such as EmBoux, which does not have that Odoo daily limit.
- If you split your list into segments (mailing filters), you need one mailing per segment. A segment without a mailing receives nothing.
- Follow the sending best practices to keep your campaigns out of the spam folder.
Receiving Mail: Catch-All
Section titled “Receiving Mail: Catch-All”A mailbox marked Catch-All receives every message addressed to its domain that does not match another mailbox or alias. Only one mailbox per domain can be the catch-all.
You can enable Catch-All either by ticking the toggle on the creation form (the alias is installed at the same time as the mailbox) or by flipping it later on an existing mailbox. Removing the flag or deleting the mailbox also removes the catch-all alias automatically.