-
Notifications
You must be signed in to change notification settings - Fork 64.8k
Description
Code of Conduct
- I have read and agree to the GitHub Docs project's 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.