# Zulip GitHub integration

Get GitHub notifications in Zulip!

!!! tip ""

    If you also configure a [custom profile
    field](/help/custom-profile-fields) for GitHub accounts, this
    integration will refer to GitHub users using [Zulip silent
    mentions](/help/mention-a-user-or-group#silently-mention-a-user),
    rather than their GitHub username.

{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 repositories.
    - Whether to include the repository name in the notifications.
    - Whether to include emoji indicators in the notifications.


1. On your repository's web page, go to **Settings**. Select **Webhooks**,
   and click **Add webhook**. GitHub may prompt you for your password.

1. Set **Payload URL** to the URL generated above. Set **Content type**
   to `application/json`. Select the [events](#filtering-incoming-events)
   you'd like to be notified about, and click **Add Webhook**.

{end_tabs}

{!congrats.md!}

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

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

### Related documentation

- [GitHub's webhook events documentation][github-webhook-events]

- [Zulip GitHub Actions integration](/integrations/github-actions)

{!webhooks-url-specification.md!}

[github-webhook-events]: https://docs.github.com/en/webhooks-and-events/webhooks/webhook-events-and-payloads