GitHub Integration

Link pull requests and commits to Velocity issues.

Setup

Go to Settings → Integrations and click Connecton the GitHub card. You will be redirected to GitHub to authorize the Velocity OAuth app. Select the repositories you want to connect.

PR Linking

When a pull request title or body contains a Velocity issue identifier (e.g., ENG-42), Velocity automatically links the PR to the issue. The link appears in the issue's activity feed.

Commit Mentions

Commit messages that mention issue identifiers are also tracked. Include the identifier anywhere in the commit message:

git commit -m "Fix pagination bug ENG-42"

Webhook Events

The GitHub integration processes the following webhook events:

• pull_request.opened — links PR to mentioned issues
• pull_request.merged — records merge event on linked issues
• pull_request.closed — records closure event
• push — scans commits for issue mentions

Security

All incoming webhooks are verified using HMAC-SHA256 signature validation. The webhook secret is generated during setup and stored securely. Invalid signatures are rejected with a 401 response.