Skip to content

GitHub

Links pull requests and commits to tickets. This app only receives; nothing is sent to GitHub.

Setup

  1. In Stoneity open Settings → Apps → Marketplace → GitHub → Install, enter a webhook secret you choose, and pick what should happen on open, on push and on merge.
  2. Copy the inbound address from Installed apps → GitHub → Settings.
  3. In GitHub open the repository (or organisation) Settings → Webhooks → Add webhook:
    • Payload URL — the inbound address
    • Content typeapplication/json
    • Secret — the same secret you entered in Stoneity
    • EventsPull requests and, if you enabled commit notes, Pushes

How tickets are matched

A ticket number in the pull request title, branch name, description or a commit message links that pull request to the ticket:

INC-1042 fix printer queue
feature/INC-1042-printer-queue
Fixes INC-1042

One pull request can reference several tickets, and each of them gets the link and the notes.

Behaviour

ChangeResult
Pull request opened or reopenedLink created, internal note on the ticket
Pull request mergedNote, and the ticket is resolved if you chose that
Pull request closed without mergeNote, link marked closed
Commit pushed mentioning a ticketInternal note with the commit message, if enabled

The pull request appears on the ticket under the Links tab, showing its current state.

Notes

  • Every request must carry a valid X-Hub-Signature-256 computed with your secret; unsigned or mismatched requests are rejected and logged.
  • Lowercase references (inc-1042) are ignored on purpose, so ordinary prose does not create links.

Stoneity Public API v1