Obtaining a Refresh Token

The following program can be used to obtain a refresh token with the desired scopes. Such a token can be used in conjunction with the refresh_token keyword argument using in initializing an instance of Reddit. A list of all possible scopes can be found in the reddit API docs

#!/usr/bin/env python

"""This example demonstrates the flow for retrieving a refresh token.

In order for this example to work your application's redirect URI must be set to

This tool can be used to conveniently create refresh tokens for later use with your web
application OAuth2 credentials.

import random
import socket
import sys

import praw

def receive_connection():
    """Wait for and then return a connected socket..

    Opens a TCP connection on port 8080, and waits for a single client.

    server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    server.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
    server.bind(("localhost", 8080))
    client = server.accept()[0]
    return client

def send_message(client, message):
    """Send message to client and close the connection."""
    client.send(f"HTTP/1.1 200 OK\r\n\r\n{message}".encode("utf-8"))

def main():
    """Provide the program's entry point when directly executed."""
        "Go here while logged into the account you want to create a token for: "
        "Click the create an app button. Put something in the name field and select the"
        " script radio button."
    print("Put http://localhost:8080 in the redirect uri field and click create app")
    client_id = input(
        "Enter the client ID, it's the line just under Personal use script at the top: "
    client_secret = input("Enter the client secret, it's the line next to secret: ")
    commaScopes = input(
        "Now enter a comma separated list of scopes, or all for all tokens: "

    if commaScopes.lower() == "all":
        scopes = ["*"]
        scopes = commaScopes.strip().split(",")

    reddit = praw.Reddit(
    state = str(random.randint(0, 65000))
    url = reddit.auth.url(scopes, state, "permanent")
    print(f"Now open this url in your browser: {url}")

    client = receive_connection()
    data = client.recv(1024).decode("utf-8")
    param_tokens = data.split(" ", 2)[1].split("?", 1)[1].split("&")
    params = {
        key: value for (key, value) in [token.split("=") for token in param_tokens]

    if state != params["state"]:
            f"State mismatch. Expected: {state} Received: {params['state']}",
        return 1
    elif "error" in params:
        send_message(client, params["error"])
        return 1

    refresh_token = reddit.auth.authorize(params["code"])
    send_message(client, f"Refresh token: {refresh_token}")
    return 0

if __name__ == "__main__":