Simple discord webhook with python

webhook.py

import requests # dependency

url = "<your url>" # webhook url, from here: https://i.imgur.com/f9XnAew.png

# for all params, see https://discordapp.com/developers/docs/resources/webhook#execute-webhook
data = {
    "content" : "message content",
    "username" : "custom username"
}

# leave this out if you dont want an embed
# for all params, see https://discordapp.com/developers/docs/resources/channel#embed-object
data["embeds"] = [
    {
        "description" : "text in embed",
        "title" : "embed title"
    }
]

result = requests.post(url, json = data)

try:
    result.raise_for_status()
except requests.exceptions.HTTPError as err:
    print(err)
else:
    print(f"Payload delivered successfully, code {result.status_code}.")

# result: https://i.imgur.com/DRqXQzA.png

As a noob in http requests and just python in general, this is really awesome, thank you

Just want to thank you, I ended up modifying this script for my own webhook!

Noobs assemble! Same as the people above, thanks alot for this!!

Thanks man, this was super useful and simple to use.

thanks for making, super simple, easy to use. :)

thanks!

tysm

this does multiple things in a weird way that it doesn't need to, like assigning to a dict after creating it and manually dumping JSON instead of letting requests handle it.

I recommend this simpler variant:

import requests

url = "<your webhook url>"

embed = {
    "description": "text in embed",
    "title": "embed title"
    }

data = {
    "content": "message content",
    "username": "custom username",
    "embeds": [
        embed
        ],
}

headers = {
    "Content-Type": "application/json"
}

result = requests.post(url, json=data, headers=headers)
if 200 <= result.status_code < 300:
    print(f"Webhook sent {result.status_code}")
else:
    print(f"Not sent with {result.status_code}, response:\n{result.json()}")

i am new to this and this helped a lot, but i just found out that you don't really need to define the headers or pass them as a parameter if you are passing the data into JSON, like laundmo did just above. the code defined below would just work fine as the one above.

`import requests

url = "put webhook url"

embed = {
    "description": "text in embed",
    "title": "embed title"
    }

data = {
    "content": "message content",
    "username": "custom username",
    "embeds": [
        embed
        ],
}


result = requests.post(url, json=data)
if 200 <= result.status_code < 300:
    print(f"Webhook sent {result.status_code}")
else:
    print(f"Not sent with {result.status_code}, response:\n{result.json()}")

@z0ned-out you're right of course, requests will set the header automatically

Hey, thank you for the recommendations @laundmo and @z0ned-out. I have integrated them into the code and also updated the linked example images for the newest discord layout.

Note that f-strings are not used in the example to preserve compatibility with versions below Python 3.6. With f-strings the last line could be print(f"Payload delivered successfully, code {result.status_code}.").

@Bilka2 Python 3.5 has already reached its End of Life, there is no reason to support it. f-strings are way more performant and readable than .format and as such should ideally be used.

My desire to support pre-3.6 is a good enough reason to keep the code how it is.

Is there a way to attach embed images?

Hey guys, is there a way to send texts that are actually links?
like in html e.g(Text)
I am trying to send shoe sizes as a message to my chanel, and I want to be able to click on those sizes and itll take me to the respective page of each size

@andyias you can use markdown links in the webhook content

[the link](https://example.com)

this is something unique to webhooks, and won't work for normal discord messages.

@Senoel i recommend taking a look at https://leovoel.github.io/embed-visualizer/ (make sure to click on "webhook mode")

you can also take a look at https://birdie0.github.io/discord-webhooks-guide/structure/file.html for sending files without an embed

very useful

very useful, since im a noob with python :D

Neat, thanks!

how would one attach a file?
do we just use .read() for the contents? and where does the file name go?