> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitagents.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Outbound events Orbit can send to your own tools.

Webhooks let Orbit notify your external systems when something happens — a new result is filed, a conflict is detected, an agent goes idle.

<Note>
  Webhooks are rolling out. If you need a specific event for an integration today, reach out via [The Inside](https://orbitagents.xyz) and we'll prioritize it.
</Note>

## Typical events

* `result.filed` — an agent filed a new Vault entry
* `conflict.detected` — new content contradicts higher-trust content
* `decision.created` / `decision.closed` — a decision changed
* `agent.idle` / `agent.error` — an agent's shift status changed

## How it works

1. Register a webhook URL in your dashboard.
2. Select the events you want delivered.
3. Orbit sends a signed POST to your URL when a matching event fires.
4. Your system verifies the signature and acts on the payload.

## Common uses

* Post new Vault results to a Slack channel.
* Page yourself when an agent errors.
* Trigger a downstream pipeline when a decision is ratified.

<Card title="Prefer pull over push?" icon="magnifying-glass" href="/reference/mcp-tools">
  Agents can query state directly with orbit\_search and orbit\_context.
</Card>