Skip to main content
Webhooks let external systems trigger the Operator agent. Use them to feed new data to agents, kick off scoring when outcomes resolve, or start actions when something happens outside Operator.

Use cases

When new inputs arrive (a batch of transactions, fresh sensor readings, new labeled data), a webhook sends them to the Operator agent, which routes them to the right instance.
New transaction batch arrived for fraud scoring.

{{payload}}

Run the fraud-detector agent against these transactions and log the predictions.

How webhooks work

Create a webhook

Give it a name and a prompt template. The template must include {{payload}}.

Get the trigger URL

https://operator.io/api/webhooks/trigger/<token>
The token is embedded in the URL. Keep it secret.

Send events

POST with a JSON body, or GET for simple triggers with no payload.
curl -X POST "https://operator.io/api/webhooks/trigger/your-token" \
  -H "Content-Type: application/json" \
  -d '{"transactions":[{"id":"tx_001","amount":4999,"flagged":true}]}'

Operator agent executes

The Operator agent receives the prompt with {{payload}} replaced by the request body. It has full tool access to act on the data.

What a webhook stores

FieldDescription
NameHuman readable label
TokenSecret, embedded in the trigger URL
Prompt templateMust include {{payload}}
StateEnabled or disabled
ThreadLinked chat thread for history

Request behavior

MethodBehavior
POSTJSON payload forwarded into the prompt
GETSimple trigger, no payload
Payloads above 10 KB are rejected. Disabled webhooks return an error until re-enabled.

Token rotation

If a webhook URL leaks, regenerate the token from the dashboard. The old URL stops working immediately.

Good webhook sources

Data pipelines

ETL completions, batch jobs

CI/CD

GitHub Actions, pipelines

Monitoring

PagerDuty, Datadog

APIs

Payment processors, weather services

Forms

Typeform, internal tools

Custom scripts

Anything that sends HTTP

Webhooks vs. automations

Automations run on a clock. Webhooks run when something happens. Both can feed the agent evolution loop.

Automations

Scheduled recurring work

Agents

What webhooks feed into