GitHub integration

Connect a GitHub repository to Traken so that releases are logged automatically when a release or deployment event fires.

Set up the connection

1. Create a connection in Traken

1. 1Go to Integrations.
2. 2
   Fill in:

   • Name — a label for this connection, e.g. "frontend prod".
   • Team (optional) — releases from this connection will be tagged with this team.
   • Subsystem (optional) — releases will be tagged with this subsystem.
3. 3Click Create connection. Traken generates a Webhook URL and a Secret.
4. 4Copy both values. The secret is shown once — you cannot retrieve it later. If you lose it, regenerate it from the connection settings.

2. Configure the webhook in GitHub

1. 1In GitHub, open your repository and go to Settings → Webhooks.
2. 2Click Add webhook.
3. 3Paste the Webhook URL into the Payload URL field.
4. 4Set Content type to application/json.
5. 5Paste the Secret into the Secret field.
6. 6
   Under Which events would you like to trigger this webhook?, select Let me select individual events, then check the events you want to track (you don't need to enable all of them — pick only what's relevant to your workflow):

   • Releases — fires when a release is published in GitHub.
   • Deployments — fires when a deployment status changes. Only successful deployments create a release in Traken.
7. 7Click Add webhook.

What you'll see in Traken

For each event type, Traken creates a release with the following fields:

Team and subsystem are always taken from the connection configuration, not from the GitHub payload.

Manage connections

Each connection appears in the Integrations → Connections list with its name, team, subsystem, and the timestamp of the last event received. To remove a connection, click Delete.