Documentation | m8tes.ai

These are outbound webhook events — your server gets notified when runs complete. For inbound webhooks that start runs, see Webhook Triggers.

Register webhook endpoints to receive real-time notifications when runs complete, fail, or need input. Events are delivered as signed HTTP POST requests with automatic retries.

Register a Webhook

Important: The secret is only shown once, on creation. Store it securely for signature verification.

Available Events

Event	Description	Default
`run.started`	A run began execution (fires on every attempt, including replies/resumes)	No
`run.completed`	A run finished successfully	Yes
`run.failed`	A run encountered an error or was cancelled	Yes
`run.awaiting_input`	A run is waiting for user input or approval	No

Payload Format

JSON

Signature Verification

Each request includes Webhook-Id, Webhook-Timestamp, and Webhook-Signature headers. Use the SDK helper to verify:

Python

Manage Webhooks

Retry Behavior

Delivery is attempted up to 3 times total with exponential backoff between attempts (2s, 4s delay). A delivery is considered successful on any 2xx response. After all attempts are exhausted, the delivery is marked as failed and visible in the delivery log via client.webhooks.list_deliveries(). Pending deliveries are also retried automatically if the server restarts.

What's Next

Webhook Triggers — inbound webhooks that start runs
Streaming & Events — consume run events in real-time via SSE
Scheduling — automate runs with cron and interval triggers