Register a webhook

Mate receives GitLab events through a webhook you register on each project. This step is manual: the console gives you the URL and secret; you paste them into GitLab.

This is Step 5 of the onboarding wizard.

What the console shows

The wizard displays:

• Webhook URL — https://ingest.mate.engineer/hook/<your-tenant-id>. Use the copy button next to it.
• Secret token — shown in full only during this step. If you missed it, you can rotate the secret from Settings → Webhook, which generates a new one.

Add the webhook in GitLab

1. In GitLab, open the project you want Mate to work in.

2. Go to Settings → Webhooks.

3. Click Add new webhook.

4. Paste the Webhook URL from the console into the URL field.

5. Paste the Secret token into the Secret token field.

6. Under Trigger, enable the following event types:

   Event type	Why
   Work item events	Issues assigned to the bot, labels applied
   Merge request events	MRs opened or assigned to the bot, labels applied
   Comments	Mentions like @your-bot in issue or MR threads
   Pipeline events	Failed pipelines on branches with an open MR

   Leave all other event types unchecked (push events, tag events, deployment events, releases, wiki, vulnerability, and so on — Mate does not consume them).

   If you want Mate to react to confidential issues or confidential comments, also enable the corresponding “Confidential” variants.

7. Click Add webhook.

You can verify the registration with GitLab’s Test button (send a test push event). Mate will receive and discard it without error.

Back in the console

Tick I’ve added this webhook to GitLab, then click Finish setup.

The wizard closes and you land on the tenant overview.

Caution

Register the webhook on every project where you want Mate to run. One tenant can serve multiple projects; each project needs its own webhook pointing to the same URL with the same secret.

Next: Run your first job