Skip to content
Rainrail Docs

GitHub webhook normalization

GitHub webhook payloads enter Rainrail through source adapters. Workflows should consume normalized Rainrail events instead of depending on raw webhook bodies.

Normalized areas

Section titled “Normalized areas”
  • Issues, pull requests, check runs, and reviews become neutral event names.
  • Repository, actor, subject, action, status, and conclusion fields are shaped into dashboard-safe routing metadata.
  • Raw provider payloads stay behind references or redacted markers.

Source spec

Section titled “Source spec”

The full normalization rules live in docs/github-webhook-normalization.md.