Integrations & API: Build Anything on OEC.sh

What You Can Build

A few patterns we see most often. None of these require us to ship custom features for you. The primitives are already there.

Public API v1

Full read/write access via REST.

Everything you can do in the dashboard, you can do over HTTP. JWT-authenticated. Idempotency keys on every mutating call. Cursor pagination on lists. Sensible rate limits.

Trigger a deploy with a single curl call:

curl -X POST https://platform.oec.sh/api/v1/environments/{env_id}/deploy \
  -H "Authorization: Bearer $OECSH_API_KEY" \
  -H "Idempotency-Key: deploy-$(date +%s)"

Webhooks

Listen to events from Git providers and external systems.

Webhooks go both ways. Receive them from GitHub, GitLab, Bitbucket, or any HTTPS source. Send them out to Slack, Teams, Discord, or your own service. Every attempt is logged. Endpoints that fail repeatedly get auto-paused so you do not flood a broken receiver.

Verify a webhook signature in Python:

import hmac, hashlib, os

def verify(request_body: bytes, signature_header: str) -> bool:
    secret = os.environ["OECSH_WEBHOOK_SECRET"].encode()
    expected = hmac.new(secret, request_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature_header)

# Flask example
# raw = request.get_data()
# sig = request.headers.get("X-OECSH-Signature", "")
# if not verify(raw, sig):
#     abort(401)

Automation Rules

Workflow engine for Odoo operations.

Rules are simple. A trigger fires, conditions match, actions run. Use them to keep environments in sync, ship branches automatically, or run scheduled cleanup.

Communication Channels

Pick the channel your team already uses. We format the payload natively for each.

Email notifications are also available on every plan.

AI Tools via MCP

Connect Claude Code, Cursor, or any MCP-compatible agent to your Odoo instance.

Model Context Protocol gives AI agents structured access to tools and data. We ship an MCP server that exposes your live Odoo. Read records, create them, run methods, automate workflows, all from the agent of your choice.

Git Providers

Plan Availability

Frequently Asked Questions