Skip to content

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

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.

Activity

  1. added
    triageDo not begin working on this issue until triaged by the team
    on Dec 8, 2025
  2. jothilakshmij commented on Dec 16, 2025

    @jothilakshmij

    i am working on this issue

  3. cx-michal-dzimitrovsky commented on Dec 16, 2025

    @cx-michal-dzimitrovsky
    Author

    @jothilakshmij Can i based on those values meanwhile?

  4. cx-michal-dzimitrovsky commented on Dec 18, 2025

    @cx-michal-dzimitrovsky
    Author
  5. added
    webhooksContent related to webhooks
    and removed
    triageDo not begin working on this issue until triaged by the team
    on Dec 31, 2025
  6. Sharra-writes commented on Jan 5, 2026

    @Sharra-writes
    Contributor

    @cx-michal-dzimitrovsky Let me look into this one. We don't deal with a lot of webhooks issues, so it will be good to find out which team currently owns that feature.

  7. cx-michal-dzimitrovsky commented on Jan 12, 2026

    @cx-michal-dzimitrovsky
    Author

    @Sharra-writes Thanks
    I'm looking forward to it.

  8. usmanu9777-hue commented on Jan 13, 2026

    @usmanu9777-hue
  9. github-actions commented on Mar 9, 2026

    @github-actions
    Contributor

    A stale label has been added to this issue, because it has been open for 30 days with no activity. If you think this issue should remain open, please add a new comment.

  10. added
    InactiveWill be closed automatically by a stall check if no activity is detected.
    on Mar 9, 2026
  11. cx-michal-dzimitrovsky commented on Mar 9, 2026

    @cx-michal-dzimitrovsky
    Author

    I wait to this PR to merged
    #41884

  12. removed
    InactiveWill be closed automatically by a stall check if no activity is detected.
    on Mar 11, 2026
  13. subatoi commented on Sep 3, 2026

    @subatoi
    Contributor

    @cx-michal-dzimitrovsky Please accept my apologies for the late reply here—there's been some confusion about the PR that was raised unofficially by a member of the community.

    I would kindly ask that you raise this in the https://github.com/github/rest-api-description repository, as the API docs are where this information should live, via the schema, and if there's information in the schema that should be exposed then that's the right repository to raise an issue.

    Again, please accept my sincere apologies for the late reply. For now I'm going to close this issue out.

  14. jothilakshmij commented on Oct 7, 2026

    @jothilakshmij
  15. brianwhitneyhoffmann093-beep commented on Oct 11, 2026

    @brianwhitneyhoffmann093-beep
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamwebhooksContent related to webhooks

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions