zulip/zerver/webhooks/github/doc.md

Zulip GitHub integration

Get GitHub notifications in Zulip!

{start_tabs}

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

2. 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, and whether to exclude notifications from private repositories.

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

4. Set Payload URL to the URL generated above. Set Content type to application/json. Select the events you'd like to be notified about, and click Add Webhook.

{end_tabs}

{!congrats.md!}

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

Related documentation

• GitHub's webhook events documentation

• Zulip GitHub Actions integration

{!webhooks-url-specification.md!}