Webhooks and Event Triggers

Webhooks let Nomotic send real-time event notifications to any URL you specify. Event triggers let external systems start agents or workflows in response to events. Together they connect Nomotic to the rest of your infrastructure.

Setting up a webhook

Go to Orchestration → Triggers → New Webhook. Give it a name and paste your endpoint URL. Nomotic will send POST requests to that URL when selected events occur.

Choose which events to send. Available events include:

Evaluation completed — fired for every evaluation. High volume on active agents.

Verdict issued — fired when a specific verdict type occurs. You can filter to ESCALATE only, DENY only, or all verdicts.

Drift alert created — fired when a new drift alert is generated.

Agent state changed — fired when an agent is activated, deactivated, promoted, or retired.

Escalation resolved — fired when a team member approves or denies an escalation.

Webhook payload format

All webhooks send JSON with a consistent structure:

json

{
  "event": "verdict.issued",
  "timestamp": "2026-04-11T14:32:00Z",
  "organization_id": "org_abc123",
  "data": {
    "evaluation_id": "eval_xyz789",
    "agent_id": "agent_123",
    "verdict": "ESCALATE",
    "ucs": 0.4821,
    "action": "send_email",
    "target": "customer@example.com"
  }
}

Securing your webhook endpoint

Each webhook includes a signature header X-Nomotic-Signature containing an HMAC-SHA256 signature of the payload. Verify this signature on your endpoint before processing the event.

Triggering agents from external events

To trigger an agent run from an external system, configure an inbound webhook trigger in Orchestration → Triggers → New Inbound Trigger. Nomotic generates a URL your external system can POST to. You can add conditions — the agent only starts if the incoming payload meets your criteria.