GitLab integration

Connect a GitLab project to Traken so that releases are logged automatically when a release, deployment, or tag push event fires — no manual step after setup.

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. "backend-api 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 token.
4. 4Copy both values. The secret token is shown once — you cannot retrieve it later. If you lose it, regenerate it from the connection settings.

2. Configure the webhook in GitLab

1. 1In GitLab, open your project and go to Settings → Webhooks.
2. 2Click Add new webhook.
3. 3Paste the Webhook URL into the URL field.
4. 4Paste the Secret token into the Secret token field.
5. 5
   Under Trigger, select the events you want to track (you don't need to enable all of them — pick only what's relevant to your workflow):

   • Release events — fires when a GitLab Release is created or updated.
   • Deployment events — fires when a deployment completes. Only successful deployments create a release in Traken.
   • Tag push events — fires when a tag is pushed to the repository.
6. 6Click Add webhook.

From this point, matching GitLab events create a release in Traken automatically.

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 GitLab 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 — the endpoint stops accepting events immediately.