Help/API & Integrations/Outbound webhooks

Outbound webhooks

WinsPipe can POST JSON to HTTPS endpoints you register in Settings → Webhooks. Use this to notify a chat tool, a queue, or your own service when publishing happens.

Only a signed-in human can create or delete endpoints. Agent keys can list them.

How to connect

1. Open Settings → Webhooks. 2. Click Create a Webhook. 3. Paste an https:// URL (or http:// in local development). 4. Save. WinsPipe sends published, failed, and reconnect_needed to that URL.

How to use

Each delivery is POST with Content-Type: application/json and an HMAC signature in X-Stories-Signature (sha256=…). Verify the hex digest with the secret shown once at create time. Failures retry with backoff; after a failure budget the endpoint is disabled and the delivery is dead-lettered. Retries never roll back a successful publish.

Events

A catalog of first-party webhooks (and, later, community webhooks) lives on the same Settings page.