zerver/webhooks/gitlab/doc.md
Receive GitLab notifications in Zulip!
!!! tip ""
If you also configure a [custom profile
field](/help/custom-profile-fields) for GitLab accounts, this
integration will refer to GitLab users using [Zulip silent
mentions](/help/mention-a-user-or-group#silently-mention-a-user),
rather than their GitLab name.
{start_tabs}
{!create-an-incoming-webhook.md!}
Decide where to send {{ integration_display_name }} notifications, and generate the integration URL. You'll be able to configure which branches you'll receive notifications from, whether to exclude notifications from private projects, and whether to include the merge request title in addition to the merge request ID in the topic name.
Go to your repository on GitLab and click Settings on the left sidebar. Click on Webhooks and select Add new webhook.
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!}
{!webhooks-url-specification.md!}