Files
zulip/zerver/webhooks/gitlab/doc.md
Lauryn Menard 0af56bb80b integrations: Update GitLab doc to direct to create webhook.
GitLab has both integrations and webhooks, and our documentation
should direct users to the webhooks set up for integrating with
Zulip.

Adds a link to GitLab's create a webhook documentation as well.
2025-09-17 09:39:48 -07:00

1.5 KiB

Zulip GitLab integration

Receive GitLab notifications in Zulip!

{start_tabs}

  1. {!create-an-incoming-webhook.md!}

  2. {!generate-webhook-url-with-branch-filtering.md!}

  3. Go to your repository on GitLab and click Settings on the left sidebar. Click on Webhooks and select Add new webhook.

  4. Set URL to the URL you generated, and Name to a name of your choice, such as Zulip. Select the events you would like to receive notifications for, and click Add Webhook.

!!! warn ""

**Note**: If your GitLab server and your Zulip server are on a local network
together, and you're running GitLab 10.5 or newer, you may need to enable
GitLab's "Allow requests to the local network from hooks and
services" setting (by default, recent GitLab versions refuse to post
webhook events to servers on the local network).  You can find this
setting near the bottom of the GitLab "Settings" page in the "Admin area".

{end_tabs}

{!congrats.md!}

{!event-filtering-additional-feature.md!}

Configuration options

  • By default, the Zulip topics for merge requests will contain the title of the GitLab merge request. You can change the topic format to just contain the merge request ID by adding &use_merge_request_title=false to the generated URL.

{!webhooks-url-specification.md!}