# GitHub webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/github/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill github-webhooks` ([details](https://hookdeck.com/webhooks/github/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [GitHub's official docs](https://docs.github.com/en/webhooks/webhook-events-and-payloads).

[Overview](https://hookdeck.com/webhooks/github) · [Webhook events (76)](https://hookdeck.com/webhooks/github/events) · [MCP events](https://hookdeck.com/webhooks/github/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/github/verify) · [Production guide](https://hookdeck.com/webhooks/github/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/github/skill)

## checks

### check_run

Confidence: documented · Schema: from GitHub docs (example)

Check run created, completed or re-requested

Identified by: x-github-event header and action field in the body · Object: `checks`

```json
{
  "action": "created",
  "check_run": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/check-run.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/check-run.json)

### check_suite

Confidence: documented · Schema: from GitHub docs (example)

Check suite requested, re-requested or completed

Identified by: x-github-event header and action field in the body · Object: `checks`

```json
{
  "action": "completed",
  "check_suite": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/check-suite.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/check-suite.json)

### merge_group

Confidence: documented · Schema: from GitHub docs (example)

Merge queue group requests checks or is destroyed

Identified by: x-github-event header and action field in the body · Object: `checks`

```json
{
  "action": "checks_requested",
  "merge_group": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/merge-group.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/merge-group.json)

### status

Confidence: documented · Schema: from GitHub docs (example)

A Git commit's status changes

Identified by: x-github-event header and action field in the body · Object: `checks`

```json
{
  "id": 6805126730,
  "sha": "6113728f27ae82c7b1a177c8d03f9e96e0adf246",
  "name": "Codertocat/Hello-World",
  "target_url": null,
  "context": "default",
  "description": null,
  "state": "success",
  "commit": { … },
  "branches": [ … ],
  "created_at": "2019-05-15T15:20:55+00:00",
  "updated_at": "2019-05-15T15:20:55+00:00"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/status.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `6805126730` |
| `state` | string | `success` |
| `created_at` | string | `2019-05-15T15:20:55+00:00` |

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/status.json)

## code

### push

Confidence: verified · Schema: from a captured delivery

Commits or tags pushed, or a branch or tag deleted

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "ref": "refs/tags/demo",
  "before": "0000000000000000000000000000000000000000",
  "after": "b03b17320c22d5e46c5e302a150fdbe3abe39735",
  "repository": { … },
  "pusher": { … },
  "sender": { … },
  "created": true,
  "deleted": false,
  "forced": false
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/push.json)

| Key field | Type | Example |
|---|---|---|
| `created` | boolean | `true` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/push.json)

### release

Confidence: verified · Schema: from a captured delivery

Release created, published, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "action": "released",
  "release": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/release.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/release.json)

### create

Confidence: verified · Schema: from a captured delivery

Git branch or tag created

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "ref": "demo",
  "ref_type": "tag",
  "master_branch": "main",
  "description": null,
  "pusher_type": "user",
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/create.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/create.json)

### delete

Confidence: verified · Schema: from a captured delivery

Git branch or tag deleted

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "ref": "jane-doe-patch-1",
  "ref_type": "branch",
  "pusher_type": "user",
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/delete.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/delete.json)

### commit_comment

Confidence: documented · Schema: from GitHub docs (example)

Someone comments on a commit

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "action": "created",
  "comment": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/commit-comment.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/commit-comment.json)

### fork

Confidence: documented · Schema: from GitHub docs (example)

A repository gets forked

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "forkee": { … },
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/fork.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/fork.json)

### gollum

Confidence: documented · Schema: from GitHub docs (example)

Wiki page created or updated

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "pages": [ … ],
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/gollum.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/gollum.json)

### page_build

Confidence: documented · Schema: from GitHub docs (example)

GitHub Pages build attempted, successful or not

Identified by: x-github-event header and action field in the body · Object: `code`

```json
{
  "id": 130514899,
  "build": { … },
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/page-build.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `130514899` |

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/page-build.json)

## deployment

### deployment

Confidence: documented · Schema: from GitHub docs (example)

Deployment created for a repository

Identified by: x-github-event header and action field in the body · Object: `deployment`

```json
{
  "deployment": { … },
  "action": "created",
  "workflow": { … },
  "workflow_run": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/deployment.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/deployment.json)

### deploy_key

Confidence: documented · Schema: from GitHub docs (example)

Deploy key added to or removed from a repository

Identified by: x-github-event header and action field in the body · Object: `deployment`

```json
{
  "action": "created",
  "key": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/deploy-key.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/deploy-key.json)

### deployment_protection_rule

Confidence: documented · Schema: No payload yet

Protection rule requested for a deployment environment

Identified by: x-github-event header and action field in the body · Object: `deployment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/deployment-protection-rule.json)

### deployment_review

Confidence: documented · Schema: from GitHub docs (example)

Deployment review requested, approved or rejected

Identified by: x-github-event header and action field in the body · Object: `deployment`

```json
{
  "action": "requested",
  "workflow_run": { … },
  "since": "2023-07-04T09:28:15Z",
  "workflow_job_run": { … },
  "environment": "TST",
  "reviewers": [ … ],
  "requestor": { … },
  "repository": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/deployment-review.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/deployment-review.json)

### deployment_status

Confidence: documented · Schema: from GitHub docs (example)

A deployment's status changes

Identified by: x-github-event header and action field in the body · Object: `deployment`

```json
{
  "deployment_status": { … },
  "deployment": { … },
  "action": "created",
  "check_run": { … },
  "workflow_run": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/deployment-status.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/deployment-status.json)

## installation

### github_app_authorization

Confidence: documented · Schema: from GitHub docs (example)

User withdraws a GitHub App's authorization

Identified by: x-github-event header and action field in the body · Object: `installation`

```json
{
  "action": "revoked",
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/github-app-authorization.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/github-app-authorization.json)

### installation

Confidence: documented · Schema: from GitHub docs (example)

GitHub App installed, removed, suspended or unsuspended

Identified by: x-github-event header and action field in the body · Object: `installation`

```json
{
  "action": "created",
  "installation": { … },
  "repositories": [ … ],
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/installation.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/installation.json)

### installation_repositories

Confidence: documented · Schema: from GitHub docs (example)

Repositories added to or removed from an app installation

Identified by: x-github-event header and action field in the body · Object: `installation`

```json
{
  "action": "added",
  "installation": { … },
  "repository_selection": "selected",
  "repositories_added": [ … ],
  "repositories_removed": [ … ],
  "requester": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/installation-repositories.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/installation-repositories.json)

### installation_target

Confidence: documented · Schema: No payload yet

Account holding a GitHub App installation is renamed

Identified by: x-github-event header and action field in the body · Object: `installation`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/installation-target.json)

### marketplace_purchase

Confidence: documented · Schema: from GitHub docs (example)

GitHub Marketplace plan purchased, changed or cancelled

Identified by: x-github-event header and action field in the body · Object: `installation`

```json
{
  "action": "changed",
  "effective_date": "2017-10-25T00:00:00+00:00",
  "sender": { … },
  "marketplace_purchase": { … },
  "previous_marketplace_purchase": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/marketplace-purchase.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/marketplace-purchase.json)

### personal_access_token_request

Confidence: documented · Schema: No payload yet

Fine-grained token request created, approved, denied or cancelled

Identified by: x-github-event header and action field in the body · Object: `installation`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/personal-access-token-request.json)

## issues

### issues

Confidence: documented · Schema: from GitHub docs (example)

Issue opened, edited, closed, labeled or otherwise changed

Identified by: x-github-event header and action field in the body · Object: `issues`

```json
{
  "action": "edited",
  "issue": { … },
  "changes": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/issues.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/issues.json)

### issue_comment

Confidence: verified · Schema: from a captured delivery

Comment on an issue or pull request created, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `issues`

```json
{
  "action": "created",
  "issue": { … },
  "comment": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/issue-comment.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/issue-comment.json)

### issue_dependencies

Confidence: documented · Schema: No payload yet

Blocking or blocked-by link added to or removed from an issue

Identified by: x-github-event header and action field in the body · Object: `issues`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/issue-dependencies.json)

### issue_relates_to

Confidence: documented · Schema: No payload yet

Relates-to link between two issues added or removed

Identified by: x-github-event header and action field in the body · Object: `issues`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/issue-relates-to.json)

### label

Confidence: verified · Schema: from a captured delivery

Label created, edited, archived or deleted

Identified by: x-github-event header and action field in the body · Object: `issues`

```json
{
  "action": "deleted",
  "label": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/label.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/label.json)

### milestone

Confidence: documented · Schema: from GitHub docs (example)

Milestone created, edited, opened, closed or deleted

Identified by: x-github-event header and action field in the body · Object: `issues`

```json
{
  "action": "closed",
  "milestone": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/milestone.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/milestone.json)

### sub_issues

Confidence: documented · Schema: No payload yet

Sub-issue or parent issue link added or removed

Identified by: x-github-event header and action field in the body · Object: `issues`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/sub-issues.json)

## organization

### custom_property

Confidence: documented · Schema: No payload yet

Organization custom property created, updated or deleted

Identified by: x-github-event header and action field in the body · Object: `organization`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/custom-property.json)

### custom_property_values

Confidence: documented · Schema: No payload yet

Custom property values change on a repository

Identified by: x-github-event header and action field in the body · Object: `organization`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/custom-property-values.json)

### member

Confidence: documented · Schema: from GitHub docs (example)

Repository collaborator added, removed or changed

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "action": "added",
  "member": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/member.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/member.json)

### membership

Confidence: documented · Schema: from GitHub docs (example)

User added to or removed from a team

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "action": "added",
  "scope": "team",
  "member": { … },
  "sender": { … },
  "team": { … },
  "organization": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/membership.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/membership.json)

### org_block

Confidence: documented · Schema: from GitHub docs (example)

Organization blocks or unblocks a non-member

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "action": "blocked",
  "blocked_user": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/org-block.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/org-block.json)

### organization

Confidence: documented · Schema: from GitHub docs (example)

Organization deleted, renamed or its membership changes

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "action": "renamed",
  "changes": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/organization.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/organization.json)

### sponsorship

Confidence: documented · Schema: from GitHub docs (example)

Sponsorship created, cancelled, edited or changes tier

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "action": "created",
  "sponsorship": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/sponsorship.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/sponsorship.json)

### team

Confidence: documented · Schema: from GitHub docs (example)

Team created, edited, deleted or linked to a repository

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "changes": { … },
  "action": "edited",
  "team": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/team.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/team.json)

### team_add

Confidence: documented · Schema: from GitHub docs (example)

Team added to a repository

Identified by: x-github-event header and action field in the body · Object: `organization`

```json
{
  "team": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/team-add.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/team-add.json)

## project

### project

Confidence: documented · Schema: from GitHub docs (example)

Classic project created, edited, closed, reopened or deleted

Identified by: x-github-event header and action field in the body · Object: `project`

```json
{
  "action": "created",
  "project": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/project.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/project.json)

### project_card

Confidence: documented · Schema: from GitHub docs (example)

Classic project card created, moved, converted, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `project`

```json
{
  "action": "moved",
  "changes": { … },
  "project_card": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/project-card.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/project-card.json)

### project_column

Confidence: documented · Schema: from GitHub docs (example)

Classic project column created, moved, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `project`

```json
{
  "action": "edited",
  "changes": { … },
  "project_column": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/project-column.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/project-column.json)

### projects_v2

Confidence: documented · Schema: No payload yet

Organization-level project created, edited, closed, reopened or deleted

Identified by: x-github-event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/projects-v2.json)

### projects_v2_item

Confidence: documented · Schema: from GitHub docs (example)

Project item created, edited, reordered, archived or deleted

Identified by: x-github-event header and action field in the body · Object: `project`

```json
{
  "action": "edited",
  "projects_v2_item": { … },
  "changes": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/projects-v2-item.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/projects-v2-item.json)

### projects_v2_status_update

Confidence: documented · Schema: No payload yet

Project status update created, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/projects-v2-status-update.json)

## pull_request

### pull_request

Confidence: verified · Schema: from a captured delivery

Pull request opened, closed, edited, labeled or otherwise changed

Identified by: x-github-event header and action field in the body · Object: `pull_request`

```json
{
  "action": "labeled",
  "number": 1,
  "pull_request": { … },
  "label": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/pull-request.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/pull-request.json)

### pull_request_review

Confidence: documented · Schema: from GitHub docs (example)

Pull request review submitted, edited or dismissed

Identified by: x-github-event header and action field in the body · Object: `pull_request`

```json
{
  "action": "dismissed",
  "review": { … },
  "pull_request": { … },
  "repository": { … },
  "sender": { … },
  "installation": { … },
  "organization": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/pull-request-review.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/pull-request-review.json)

### pull_request_review_comment

Confidence: documented · Schema: from GitHub docs (example)

Comment on a pull request diff created, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `pull_request`

```json
{
  "action": "edited",
  "changes": { … },
  "comment": { … },
  "pull_request": { … },
  "repository": { … },
  "installation": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/pull-request-review-comment.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/pull-request-review-comment.json)

### pull_request_review_thread

Confidence: documented · Schema: from GitHub docs (example)

Pull request comment thread resolved or unresolved

Identified by: x-github-event header and action field in the body · Object: `pull_request`

```json
{
  "action": "resolved",
  "pull_request": { … },
  "thread": { … },
  "repository": { … },
  "installation": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/pull-request-review-thread.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/pull-request-review-thread.json)

## repository

### star

Confidence: verified · Schema: from a captured delivery

Repository starred or unstarred

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "created",
  "starred_at": "2023-03-06T04:19:17Z",
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/star.json)

| Key field | Type | Example |
|---|---|---|
| `starred_at` | string | `2023-03-06T04:19:17Z` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/star.json)

### ping

Confidence: verified · Schema: from a captured delivery

Test event sent when a webhook is created

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "zen": "Speak like a human.",
  "hook_id": 403738602,
  "hook": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/ping.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/ping.json)

### branch_protection_configuration

Confidence: documented · Schema: No payload yet

All branch protections enabled or disabled for a repository

Identified by: x-github-event header and action field in the body · Object: `repository`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/branch-protection-configuration.json)

### branch_protection_rule

Confidence: documented · Schema: from GitHub docs (example)

Branch protection rule created, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "edited",
  "rule": { … },
  "changes": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/branch-protection-rule.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/branch-protection-rule.json)

### discussion

Confidence: documented · Schema: from GitHub docs (example)

Discussion created, edited, answered, closed or otherwise changed

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "edited",
  "discussion": { … },
  "changes": { … },
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/discussion.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/discussion.json)

### discussion_comment

Confidence: documented · Schema: from GitHub docs (example)

Comment on a discussion created, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "edited",
  "changes": { … },
  "comment": { … },
  "discussion": { … },
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/discussion-comment.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/discussion-comment.json)

### meta

Confidence: documented · Schema: from GitHub docs (example)

The webhook itself is deleted

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "deleted",
  "hook_id": 101047067,
  "hook": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/meta.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/meta.json)

### package

Confidence: documented · Schema: from GitHub docs (example)

GitHub Packages package published or updated

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "published",
  "package": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/package.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/package.json)

### public

Confidence: documented · Schema: from GitHub docs (example)

Private repository made public

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/public.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/public.json)

### registry_package

Confidence: documented · Schema: from GitHub docs (example)

Older package event: published or updated; prefer package

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "published",
  "registry_package": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/registry-package.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/registry-package.json)

### repository

Confidence: documented · Schema: from GitHub docs (example)

Repository created, renamed, archived, transferred or deleted

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "edited",
  "changes": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/repository.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/repository.json)

### repository_import

Confidence: documented · Schema: from GitHub docs (example)

Repository imported into GitHub, with its status

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "status": "success",
  "repository": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/repository-import.json)

| Key field | Type | Example |
|---|---|---|
| `status` | string | `success` |

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/repository-import.json)

### repository_ruleset

Confidence: documented · Schema: No payload yet

Repository ruleset created, edited or deleted

Identified by: x-github-event header and action field in the body · Object: `repository`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/repository-ruleset.json)

### watch

Confidence: verified · Schema: from a captured delivery

Someone starts watching a repository

Identified by: x-github-event header and action field in the body · Object: `repository`

```json
{
  "action": "started",
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/watch.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-github-delivery`, `x-github-event`, `x-github-hook-id`, `x-github-hook-installation-target-id`, `x-github-hook-installation-target-type`

[View as JSON](https://hookdeck.com/webhooks/github/events/watch.json)

## security

### code_scanning_alert

Confidence: documented · Schema: from GitHub docs (example)

Code scanning alert created, fixed, closed or reopened

Identified by: x-github-event header and action field in the body · Object: `security`

```json
{
  "action": "fixed",
  "alert": { … },
  "ref": "refs/pull/11/merge",
  "commit_oid": "c5bf87afac650dbcb5fd97cfc22fcae5303da8e1",
  "repository": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/code-scanning-alert.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/code-scanning-alert.json)

### dependabot_alert

Confidence: documented · Schema: from GitHub docs (example)

Dependabot alert created, dismissed, fixed or reopened

Identified by: x-github-event header and action field in the body · Object: `security`

```json
{
  "action": "fixed",
  "alert": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/dependabot-alert.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/dependabot-alert.json)

### repository_advisory

Confidence: documented · Schema: No payload yet

Repository security advisory reported or published

Identified by: x-github-event header and action field in the body · Object: `security`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/repository-advisory.json)

### repository_vulnerability_alert

Confidence: documented · Schema: from GitHub docs (example)

Older vulnerability alert event, closing down; use dependabot_alert

Identified by: x-github-event header and action field in the body · Object: `security`

```json
{
  "action": "create",
  "alert": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/repository-vulnerability-alert.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/repository-vulnerability-alert.json)

### secret_scanning_alert

Confidence: documented · Schema: from GitHub docs (example)

Secret scanning alert created, resolved, reopened or validated

Identified by: x-github-event header and action field in the body · Object: `security`

```json
{
  "action": "reopened",
  "alert": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/secret-scanning-alert.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/secret-scanning-alert.json)

### secret_scanning_alert_location

Confidence: documented · Schema: from GitHub docs (example)

New location found for a secret scanning alert

Identified by: x-github-event header and action field in the body · Object: `security`

```json
{
  "action": "created",
  "alert": { … },
  "location": { … },
  "repository": { … },
  "sender": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/secret-scanning-alert-location.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/secret-scanning-alert-location.json)

### secret_scanning_scan

Confidence: documented · Schema: No payload yet

Secret scan of a repository completes

Identified by: x-github-event header and action field in the body · Object: `security`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/secret-scanning-scan.json)

### security_advisory

Confidence: documented · Schema: from GitHub docs (example)

GitHub-reviewed global advisory published, updated or withdrawn

Identified by: x-github-event header and action field in the body · Object: `security`

```json
{
  "action": "updated",
  "security_advisory": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/security-advisory.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/security-advisory.json)

### security_and_analysis

Confidence: documented · Schema: No payload yet

Security features turned on or off for a repository

Identified by: x-github-event header and action field in the body · Object: `security`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/github/events/security-and-analysis.json)

## workflow

### workflow_run

Confidence: documented · Schema: from GitHub docs (example)

Actions workflow run requested, in progress or completed

Identified by: x-github-event header and action field in the body · Object: `workflow`

```json
{
  "action": "completed",
  "organization": { … },
  "repository": { … },
  "sender": { … },
  "workflow": { … },
  "workflow_run": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/workflow-run.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/workflow-run.json)

### repository_dispatch

Confidence: documented · Schema: from GitHub docs (example)

Custom event sent through the repository dispatches API

Identified by: x-github-event header and action field in the body · Object: `workflow`

```json
{
  "action": "on-demand-test",
  "branch": "master",
  "client_payload": { … },
  "repository": { … },
  "organization": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/repository-dispatch.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/repository-dispatch.json)

### workflow_dispatch

Confidence: documented · Schema: from GitHub docs (example)

GitHub Actions workflow triggered by hand

Identified by: x-github-event header and action field in the body · Object: `workflow`

```json
{
  "inputs": { … },
  "ref": "refs/heads/master",
  "repository": { … },
  "organization": { … },
  "sender": { … },
  "workflow": ".github/workflows/hello-world-workflow.yml"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/workflow-dispatch.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/workflow-dispatch.json)

### workflow_job

Confidence: documented · Schema: from GitHub docs (example)

Actions workflow job queued, waiting, running or finished

Identified by: x-github-event header and action field in the body · Object: `workflow`

```json
{
  "action": "queued",
  "workflow_job": { … },
  "repository": { … },
  "sender": { … },
  "installation": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/github/events/workflow-job.json)

From GitHub docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/github/events/workflow-job.json)

---

Not affiliated with GitHub. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/github.json) · [Report a correction](https://hookdeck.com/contact)
