# Supported Events WebHooker supports 28 GitHub webhook event types, each with a dedicated formatter that produces rich Discord embeds and Telegram HTML messages — plus `custom` events from signed custom JSON webhooks. Unsupported events fall through to a generic formatter. ## Events Table | Event | Description | Embed Highlights | | ----------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------- | | `push` | Code pushed to a branch | Commit list, branch, author, diff stats | | `pull_request` | PR opened/closed/merged/edited | PR title, branch, diff stats, labels | | `issues` | Issue opened/closed/edited | Issue title, labels, assignees | | `issue_comment` | Comment on issue or PR | Comment body, issue reference | | `workflow_run` | CI/CD workflow phase updated | Workflow status, conclusion, duration, colored per-job breakdown; phases update a single message in place | | `workflow_job` | CI job phase updated | Job name, status, conclusion, workflow | | `status` | Commit status updated | Commit status, context, state, commit link | | `deployment` | Deployment created | Environment, ref, task | | `deployment_status` | Deployment status updated | Environment, status, commit ref | | `check_run` | Check run phase updated | Status, conclusion, details URL; phases update a single message in place | | `check_suite` | Check suite completed | Suite conclusion, head branch, commit link | | `ping` | Webhook confirmation | Webhook confirmation, event types subscribed | | `release` | Release published/edited | Tag, body, assets, pre-release flag | | `create` | Branch or tag created | Ref name, ref type | | `delete` | Branch or tag deleted | Ref name, ref type | | `star` | Repository starred/unstarred | Star count, action | | `fork` | Repository forked | Source → target fork | | `pull_request_review` | PR review submitted | Review state (approved/changes/commented), body | | `pull_request_review_comment` | Inline code review comment | File path, line number, comment body | | `commit_comment` | Comment on a commit | Commit SHA, comment body | | `member` | Collaborator added/removed | Member login, action | | `label` | Label created/edited/deleted | Label name, color, description | | `milestone` | Milestone opened/closed | Progress bar, issue counts, due date | | `discussion` | Discussion created/answered | Title, category, action | | `discussion_comment` | Comment on discussion | Comment body, discussion reference | | `repository` | Repo renamed/transferred | Old → new name, changes | | `code_scanning_alert` | Code scanning alert | Severity, rule ID, file path | | `dependabot_alert` | Dependabot alert | Severity, package, vulnerable range, fix version | | `custom` | Signed custom JSON webhook | Arbitrary title/description/color/url/author/fields (see [Custom webhooks](../guide/ingress.md#custom-webhooks)) | ## Color Coding Each event type uses a distinct color in the Discord embed (from `server/lib/formatters/colors.ts`): | Color | Events | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Green (`#2da44e`) | PR opened / ready for review, issue opened, workflow success, release published, check success, review approved, deployment success, member added, milestone closed, discussion answered | | Green (`#2ea44f`) | push | | Red (`#f85149`) | PR closed, issue closed, workflow failure, release deleted, delete, check failure, review changes requested, deployment failure, member removed, code scanning / dependabot critical & high | | Purple (`#8957e5`) | PR merged, label, discussion | | Blue (`#1f6feb`) | PR (other actions), issue reopened, fork, milestone opened | | Yellow (`#d29922`) | workflow (queued/running/other), release prerelease, star, check (other), deployment pending, code scanning / dependabot medium | | Gray (`#6e7681`) | issue comment, commit comment, discussion comment | | Gray (`#8b949e`) | review commented, repository, code scanning / dependabot low, default | ## Generic Fallback Any event type without a dedicated formatter falls through to the generic formatter, which produces a basic embed with: - Event type as title (plus the action when available) - Actor login (author line) - Repository name in the footer ## In-Place Message Updates `workflow_run` and `check_run` events (queued → running → success/failure) are sent once and then **edited in place** for each subsequent phase instead of posting a new message. Each edit re-renders the whole message from the newest event. Check suites, deployments (and their statuses), issue comments, pull request reviews and review comments are edited in place the same way. Supported on Discord (`editMessage`), Telegram (`editMessageText` / `editMessageCaption`) and Feishu. `check_run` tracks by check suite (or app) + check name + commit SHA (falling back to the run id), so providers that issue a new run id per phase — e.g. Cloudflare Pages — still edit the same message, while same-named checks of different workflows or apps keep separate messages. An older phase never overwrites a newer one, and a deleted comment or dismissed review stays shown as such. `workflow_run` messages also carry a colored **Jobs** breakdown. Because the webhook payload itself has no job list (only a `jobs_url`), the worker fetches it from the GitHub API — authenticated with a GitHub App installation token when `GITHUB_APP_ID` / `GITHUB_PRIVATE_KEY` are set, otherwise unauthenticated (public repositories). The App therefore needs the **Actions: read** repository permission. ## Filter Compatibility See the [Filter Tutorial](../guide/filters) for a hands-on guide with worked examples. | Filter | Works With | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `event` | All events | | `repo` | All events | | `actor` | All events | | `action` | Events with `action` field in payload | | `branch` | push, pull_request, pull_request_review, pull_request_review_comment, create, delete, workflow_run, workflow_job, check_run, check_suite, deployment, deployment_status, code_scanning_alert | | `keyword` | All events (searches full payload body) |