snapshot of https://github.com/zulip/zulip.git @ 48c69911c7dd4e03b20552eb3bd77ad8151c1357 (2026-09-15)

zerver/webhooks/github/doc.md

@@ -0,0 +1,49 @@
+# 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