Skip to content

CTF-1203: Webhooks

Statement

The system could support configurable webhook notifications that POST JSON payloads to registered URLs when specified events occur (flag solve, first blood, event state change, new registration). Webhook endpoints shall be configurable per event by organizers. The system shall retry failed deliveries with exponential backoff. Webhook payloads shall include event type, timestamp, and relevant entity data.

Rationale

Webhooks enable real-time integration with external systems like Slack (solve announcements), external scoreboards, or analytics platforms without polling the API. This is a push-based complement to the pull-based REST API. While lower priority than the API itself, webhooks significantly reduce integration complexity.

Traceability

  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/models/notification.py (CTFWebhook model)
  • DOCUMENTS → GITHUB_ISSUE Brad-Edwards/bigrae#635 (CTF-1203: Webhooks)