Suspension & Lifecycle

EmBoux lets you freeze a domain’s mail delivery without deleting any data. This is useful for:

• Customers who haven’t paid
• Grace period enforcement
• Temporary service holds

Suspend Domain

PUT /domains/{domain_name}/suspend

Freezes inbound mail delivery. Existing emails and configuration are preserved. The domain remains registered but EmBoux will reject new incoming mail.

Example

curl -X PUT https://api.emboux.com/domains/mycompany.com/suspend \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "name": "mycompany.com",
  "suspended": true,
  "message": "Domain suspended"
}

Tip

Suspension is idempotent — calling it multiple times on an already-suspended domain is safe and returns the same response.

---

Activate Domain

PUT /domains/{domain_name}/activate

Restores mail delivery for a suspended domain.

Example

curl -X PUT https://api.emboux.com/domains/mycompany.com/activate \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

{
  "name": "mycompany.com",
  "suspended": false,
  "message": "Domain activated"
}

---

How It Works

When you suspend a domain:

1. EmBoux marks the domain as suspended
2. Incoming SMTP connections for the domain are rejected
3. IMAP/POP3 login attempts are blocked
4. No data is deleted — mailboxes, aliases, and stored emails remain intact

When you activate:

1. The suspension is lifted
2. Mail delivery and client access resume immediately

---

Automated Suspension (Odoo Integration)

If you’re using the EmBoux Odoo module, suspension is managed automatically:

1. Quota exceeded — Customer uses more domains than their plan allows
2. Grace period — 30-day window to regularize (with email reminders at days 7, 15, 22)
3. Auto-suspend — After grace period, excess domains are suspended (most recent first)
4. Auto-reactivate — When the customer pays or upgrades, domains are reactivated automatically

This entire flow is hands-free. See the Odoo Integration guide for details.