We rely on a GitLab Group Hook to enable:

1⃣ Syncing changes to follow-ups in GitLab back to incident.io

2⃣ Linking merge requests to incidents automatically when you mention the incident reference (e.g. INC-123) in a merge request.

3⃣ Posting updates to merge requests in the incident channel, for example when a linked MR is merged.

🛠 Setting up

1⃣ Find your secret token

Under Settings → Integrations → GitLab, you'll find a unique secret token. Copy this down - you'll need it to successfully configure the hook.

2⃣ Create the hook

Within your top-level group, click Settings then Webhooks:

Then 'Add new webhook'.

For the URL use https://app.incident.io/webhooks/gitlab.

For the Secret token, paste in the secret token from the incident.io dashboard.

Under Trigger, select:

☑ Issues events

☑ Merge request events

Everything else can be left as the default. Click Add webhook.

3⃣ Verify the connection

In Settings → Integrations → GitLab, you can see when the last webhook was received. Make a small change to an issue to trigger a webhook:

You're all set 🎉