Back to docs

Automations

Webhook actions

Send real-time HTTP notifications to your own systems when automation rules fire.

Webhook actions

A webhook action sends an HTTP POST request to a URL you specify whenever an automation fires. Use this to connect Winora events to any external system.

Adding a webhook action

  1. In an automation, click Add action → Send webhook.
  2. Enter the URL to receive the request.
  3. Optionally add custom headers (e.g. an Authorization header).
  4. Save.

Payload format

{
  "event": "automation.fired",
  "automationId": "clxxx",
  "automationName": "Tag billing questions",
  "triggeredAt": "2026-05-20T10:30:00Z",
  "conversation": {
    "id": "clyyy",
    "status": "open",
    "priority": "high",
    "channel": "widget",
    "contact": {
      "id": "clzzz",
      "name": "Jane Smith",
      "email": "jane@example.com"
    }
  }
}

Retries

If your endpoint returns a non-2xx status, Winora retries up to 3 times with exponential back-off (30s, 5m, 30m).

Testing webhooks

Use a service like webhook.site during development to inspect incoming payloads before wiring them to your production systems.