Early access A webhook sends events to one HTTPS URL. One webhook can receive many events, each with its own filters.

Events

list_webhook_events returns the exact filters and payload schemas for each event. Omit a filter to receive every value. When it also lists accountIds, omit accountIds to follow only the main account, or add the accountId of each pod from list_pods.

Create a webhook

The AI calls create_webhook with the URL and the events. The result has the signing secret. Tuyo shows the secret only once. If your receiver needs its own headers, such as Authorization, pass them as headers. Tuyo sends them with each delivery. list_webhooks shows only their names.

Verify deliveries

Deliveries follow Standard Webhooks. Verify each signature with the secret before you trust the payload.

MCP events

Clients that support the draft MCP Events extension can use events/subscribe on the early-access endpoint. Each subscription is a webhook for one event. It expires after seven days unless the request sets ttlMs.