Skip to content

Missing documentation: X-GitHub-Hook-Installation-Target-Type header values #41739

@cx-michal-dzimitrovsky

Description

@cx-michal-dzimitrovsky

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/webhooks/webhook-events-and-payloads

Specifically the section describing webhook headers.

What part(s) of the article would you like to see updated?

The documentation describes the X-GitHub-Hook-Installation-Target-Type header but doesn't provide a complete list of possible values.

Current documentation states:

X-GitHub-Hook-Installation-Target-Type: The type of resource where the webhook was created.

What's missing:

  • Complete list of all possible values for this header
  • Which value is used for GitHub App webhooks (is it integration, app, or something else?)
  • Which value is used for organization webhooks

Why this matters:
Developers need a reliable way to distinguish between repository webhooks, organization webhooks, and GitHub App webhooks. Currently, only checking for the installation property in the payload is documented, but having clarity on header values would provide an alternative method.

Expected outcome:
Add a table or list showing all possible values:

  • repository - for repository webhooks (already shown in examples)
  • organization - for organization webhooks (if this is correct)
  • The value for GitHub App webhooks (please clarify)

This would help developers make informed decisions about how to identify webhook sources.

Additional information

This affects all developers implementing webhook handlers who need to distinguish between webhook types.

The header appears in API documentation examples (e.g., in /rest/apps/webhooks and /rest/repos/webhooks) but only with the value repository. No other values are documented.

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamtriageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions