Add a user to a guild with Discord OAuth2 in Python using Requests

With the lack of tutorials regarding Discord OAuth2 and how it works, I decided to write my own guide as well as record a video along with it. This article will show how Discord's OAuth2 can be used in order to add a Discord user to a guild. We will be using Python and the requests library for this guide.

Importing reqests

Since requests is the only library we will be using, we have to import it at the top of our code.
import requests

Setting up our variables

We are going to setup 4 variables that will be used later in our code.

API_ENDPOINT = 'https://discord.com/api/v8'
CLIENT_ID = ''
CLIENT_SECRET = ''
REDIRECT_URI = "https://google.com"

For the CLIENT_ID and CLIENT_SECRET, we have to get these from Discord's Developer Portal.

Creating our Discord application

We need to create a new application, and give it a name.

After creating our application, we can click on the OAUTH2 tab to find our CLIENT_ID and CLIENT_SECRET. Copy these two values and paste them at the variable definitions above.

Setting up our redirect URI

As you probably noticed, we have a REDIRECT_URI too. This is the URI that we will be using to get the code from our user, that we then can use to exchange it for an actual access_token. But we have to add this URI in our Developer Portal. The URI does not matter, it can be anything. But we have to allow it.

Writing our `exchange_code`function.

This function will allow us to convert the code we get from the user into an access_token, which we then can use to add the user to a guild.

def exchange_code(code):
  data = {
    'client_id': CLIENT_ID,
    'client_secret': CLIENT_SECRET,
    'grant_type': 'authorization_code',
    'code': code,
    'redirect_uri': REDIRECT_URI
  }
  headers = {
    'Content-Type': 'application/x-www-form-urlencoded'
  }
  r = requests.post('%s/oauth2/token' % API_ENDPOINT, data=data, headers=headers)
  r.raise_for_status()
  return r.json()

Here, we send along our application info, and return the json object that we get back from Discord.

Writing our `add_to_guild`

This function is just an example of what we can do with the newly acquired access_token. For a full list of what you can do, check out the Discord OAUTH2 Documentation

def add_to_guild(access_token, userID, guildID):
    url = f"{API_ENDPOINT}/guilds/{guildID}/members/{userID}"
    botToken = "ODcyMjMyMjQ5ODYzNTkzOTk0.YQm3lQ.yB3pFepBcy7K1gQVrBxNfYf_Bdk"
    data = {
    "access_token" : access_token,
    }
    headers = {
    "Authorization" : f"Bot {botToken}",
    'Content-Type': 'application/json'
    }
    response = requests.put(url=url, headers=headers, json=data)
    print(response.text)

This function takes in the access_token, the guildID and the userID of the user we want to add to the guild. It also requires a bot token, which you can get from the developer portal.

We send along this bot token in our headers, and then print out the response we get from Discord. If everything went well, this should be an object with info about the user.

Finishing up our code

Now, all there is left to do is to run our functions, in the correct order.

code = exchange_code('')['access_token']
add_to_guild(code, 'USER_ID', 'GUILD_ID')

So what do we pass in to the exchange_code function? Well this is the part where the user has to go to the authorize link and authorize our application.
https://discord.com/oauth2/authorize?response_type=code&client_id=157730590492196864&scope=identify+guilds.join&state=15773059ghq9183habn&redirect_uri=https%3A%2F%2Fgoogle.com&prompt=consent
You have to plug in your own client_id and the redirect URI you decided to use.

After authorizing, the user will be sent to our redirect URI. If you look at the uri, you'll find the code that we are after.

Copy this code and paste it inside the exchange_code function.

Running our code

Before our code can actually work. We have to invite our Discord bot to the server we wish to add the user to.
https://discord.com/oauth2/authorize?client_id=123456789012345678&scope=bot+applications.commands
Again, you have to plug in your own client_id to invite your own bot.

Once it is in the server, everything is ready to work. If you want to try it out, leave the server (transfer ownership to someone else if it is your own), and then run the code with your own code and user id. If you have done everything correctly, the bot will add you back to the guild.