Source type
GitHub Source Configuration
GitHub sources receive repository, organization, GitHub App, issue, pull request, workflow, deployment, and push events with raw-body signature verification.
GitHub identifies the event with x-github-event, the delivery with x-github-delivery, and signs the raw request body in x-hub-signature-256 using HMAC-SHA256.
GitHub configuration
Create a GitHub source, keep POST and PUT and PATCH and DELETE enabled, and provide the configured Webhook Signing Secret values for provider signature. FastHook uses these settings to validate each GitHub delivery before it enters the routing workflow.
Source TypeGITHUB
Allowed methodsPOST, PUT, PATCH, DELETE
AuthenticationProvider signature
Credential fieldsWebhook Signing Secret
{
"type": "GITHUB",
"config": {
"auth_type": "PROVIDER_SIGNATURE",
"auth": {
"provider": "GITHUB",
"webhook_signing_secret": "provider-secret"
},
"allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
}
}GitHub request contract
FastHook computes HMAC-SHA256 over the exact raw request body and compares it to x-hub-signature-256 with the sha256= prefix.
GitHub headers
Preserve x-hub-signature-256, x-github-event, x-github-delivery when sending GitHub test deliveries. FastHook evaluates this request context before accepting the payload, so missing or modified values remain visible as rejected requests instead of routed events.
x-hub-signature-256HMAC-SHA256 signature with the sha256= prefix.
x-github-eventGitHub event family, useful for routing and filters.
x-github-deliveryProvider delivery id, useful for debugging and idempotency.
GitHub setup
- Create a GitHub repository, organization, or GitHub App webhook.
- Paste the generated FastHook Source URL into GitHub's Payload URL field.
- Use the same secret in GitHub and in the FastHook Webhook Signing Secret field.
GitHub routing hints
- Push, pull_request, workflow_run, release, deployment, issue, and organization events usually route by x-github-event plus payload fields.
- Use x-github-delivery as a delivery id when receivers need idempotency or support investigation.