---
# System prepended metadata

title: github/discord webhook

---

---
title: github/discord webhook
description: tutorial to create a webhook to receive github messages on discord
---

# discord webhook

got a github repository? love discord? get notifications from github right in your favorite server!

![](https://i.imgur.com/uxGSxm3.png)

1. find the discord channel in which you would like to send commits and other updates

2. in the settings for that channel, find the webhooks option and create a new webhook. note: do not give this url out to the public. anyone or service can post messages to this channel, without even needing to be in the server. keep it safe!
![discord webhook settings](https://i.imgur.com/rcNN985.png)


# step 2 - set up the webhook on github
1. navigate to your repository on github, and open the settings
![github repository settings](https://i.imgur.com/QOryvEc.png)


2. select add webhook
![github webhook settings](https://i.imgur.com/sEemYy8.png)


3. paste in the webhook url and append `/github` to the end. select "send me everything", set the type to `application/json`, and then add webhook
![github webhook settings](https://i.imgur.com/ouSBqF8.png)


4. test it by updating something or starring the repository or using the below code! if it works, you're all set!
```shell
# Push an empty commit
$ git commit --allow-empty -m "Trigger Build"
```
![discord test message](https://i.imgur.com/mIl8wTT.png)

[//]: # (dark theme)
{%hackmd f7VLvUw9SUaiu_Vgrm3B9g %}