# Outgoing Webhooks

Source HTML: https://telemhq.com/docs/webhooks

TelemHQ can send outgoing webhook requests when a tracker fails or recovers. Webhooks are useful for notifying other systems, creating incidents, posting to chat tools, or triggering automation.

## Availability

Outgoing webhooks are available on paid Pro and Team plans.

## Event Types

- `tracker.failed`: sent when a tracker enters a failing state
- `tracker.recovered`: sent when a tracker recovers

## Webhook Payload

```json
{
  "event": "tracker.failed",
  "tracker": {
    "id": "tracker_id",
    "name": "Nightly AI summary",
    "status": "failed"
  },
  "run": {
    "id": "job_run_id",
    "timestamp": "2026-05-05T12:00:00.000Z",
    "duration": 1500,
    "payload": {
      "provider": "openai",
      "model": "gpt-4.1-mini",
      "status": "failed",
      "items_failed": 3
    }
  }
}
```

## Recovery Payload

```json
{
  "event": "tracker.recovered",
  "tracker": {
    "id": "tracker_id",
    "name": "Nightly AI summary",
    "status": "active"
  },
  "run": {
    "id": "job_run_id",
    "timestamp": "2026-05-05T12:30:00.000Z",
    "duration": 1200,
    "payload": {
      "provider": "openai",
      "model": "gpt-4.1-mini",
      "status": "success",
      "items_failed": 0
    }
  }
}
```

## Best Practices

- Return a `2xx` response quickly.
- Make webhook handlers idempotent.
- Do not rely on webhook delivery as the only copy of run data; TelemHQ keeps the tracker history.
- Use HTTPS endpoints.
- Store and rotate any receiving endpoint secrets you use.

## Related Guides

- Sending pings: https://telemhq.com/docs/integration
- OpenAI pipeline tracking: https://telemhq.com/docs/openai
- Codex usage tracking: https://telemhq.com/docs/codex
- Claude pipeline tracking: https://telemhq.com/docs/claude