Github to Discord Webhook tutorial.md

Github to Discord Webhook Tutorial

In this tutorial I'll show you how to create a Github webhook that will post updates from your Github account to a channel in Discord. The steps are simple so follow along!

Create a Webhook in a Discord Channel

First you need to create a webhook in a text channel. We're assuming you have both Manage Channel and Manage Webhooks permissions!

• Go in a channel properties (Alternatively, Server Settings, Webhooks works too)
• Click Webhooks
• Click Create Webhook
• Type in a name (this is for local reference, it's overriden by the incoming hook data)
• Copy the Webhook URL (you can use the Copy button)
• Click Save

Note: Do NOT give the Webhook 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!

Create the Github Webhook

In order to do this you need to be the owner of the github repository. Even Collaborators cannot access settings.

• Click on Settings
• Click on Webhooks
• Click on Add Webhook
• The Payload URL is the webhook URL with /github added to the end.
• Leave Secret blank, change the Content-Type to application/json
• Select what type of events you want
• Click Add Webhook

Note: The "test" payload will not show anything in your channel. That is normal. You will need to actually take an action in order to show any activity. However, make sure the test payload has a green checkmark, and the response is 204.

Troubleshooting

I'm getting a 400 error!

Make sure to add /github at the end of the webhook URL.

Can I change the Avatar and Name of the hook's messages?

No, Github controls that part, so they're choosing the name and Avatar.

I'm not getting the events I want (or too many)

Under Which events would you like to trigger this webhook?, select Let me select individual events.

Check the events you'd like to receive. There are a lot of them.

Enjoy!

That's it. That's all you had to do. Now go code!

Thanks

Worked like a charm for me. Thank you!

thank you

If you get 400/404, simply make a Commit in this repo and if you see a message in discord webhook then its fine

Thank you!

Thank you!

ah, thank you, dude!

nvm how do I insert the webhook to discord

You might want to update this to note that only certain events will come through (despite getting a 204 response)

discord/discord-api-docs#6203 (comment)

No plans to add to the list :(

Works great👌

Followed and worked first time. Many thanks!

Thanks a ton. I forget to place the /github at the end every time!

Thank you ^^

Hello all past and future!

For those running into issues (like myself), I made a Discord bot to make this process a bit easier: GitHub Bot for Discord.

Just add the bot to your Discord server and use /github commands to create/delete subscriptions to various GitHub repo events. It uses the minimum permissions needed and should help make this process easier! ✅

I'm still confused what do I search up ?

Thanks.
Works like a charm.

Thank you!

Tétt

Can we customize it or not? If yes, how?