---
title: "Webhooks"
description: ""
canonical: "https://kingminos.com/docs/webhooks/"
sourceKind: "source-mdx"
---

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

OutboundSync built KingMinos to answer synchronously — every capability call returns one envelope. **Webhooks are the push counterpart**: KingMinos emits its own platform events and delivers them, signed, to HTTPS endpoints you register.

## What webhooks are for

Today the platform ships one event tranche, **Run Health**:

- `run.failed` — a workspace×capability stream transitions healthy→failing (one alert per incident, not per run)
- `run.recovered` — the same stream is healthy again
- `test.ping` — a delivery you trigger yourself to prove an endpoint works

If you call KingMinos from Salesforce Flow or a script, you already get errors synchronously. Webhooks are for the rest of your ops stack: get told when enrichment starts failing (with a `reason` and a `remediation`), when it recovers, and reconcile anything missed through the events log.

## Access

- Webhooks are **workspace-scoped**. Every `/v1/webhooks*` and `/v1/events` route returns `403 webhooks_not_enabled` until an OutboundSync admin enables webhooks for your workspace.
- Reads need any workspace-bound key; **mutations need the workspace owner**.
- At most **20 endpoints** per workspace.

<CardGrid>
  <LinkCard title="Setting up webhooks" href="/docs/webhooks/setup/" description="Register an endpoint, store the signing secret, URL rules." />
  <LinkCard title="Event types" href="/docs/webhooks/event-types/" description="Active run.failed / run.recovered / test.ping, and reserved names." />
  <LinkCard title="Payloads and signatures" href="/docs/webhooks/payloads-and-signatures/" description="The delivery envelope and how to verify KingMinos-Signature." />
  <LinkCard title="Delivery and retries" href="/docs/webhooks/delivery-and-retries/" description="At-least-once semantics, retry schedule, auto-disable." />
  <LinkCard title="Testing and troubleshooting" href="/docs/webhooks/testing-and-troubleshooting/" description="test.ping, deliveries, replay, and common failures." />
</CardGrid>