# Zulip GitLab integration

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}

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

1. Decide where to send {{ integration_display_name }} notifications, and
   [generate the integration URL](/help/generate-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.

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

1. Set **URL** to the URL you generated, and **Name** to a name of your
   choice, such as `Zulip`. Select the [events](#filtering-incoming-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!}

![](/static/images/integrations/gitlab/001.png)

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

### Related documentation

{!webhooks-url-specification.md!}
* [GitLab webhooks documentation](https://docs.gitlab.com/user/project/integrations/webhooks/#create-a-webhook)