How to Automate Discord Support Tickets using the API

Understanding the Discord API

Setting Up Discord API Authentication

Bot tokens authenticate all requests with a static credential that does not expire until reset. Use Authorization: Bot <token> in every request header. For ticket systems, the bot needs Manage Channels to create and delete channels, and Manage Roles to set permission overwrites on channels.

1. 1Go to https://discord.com/developers/applications and click New Application.
2. 2Open the Bot tab. Click Reset Token to generate your token — copy it immediately.
3. 3No privileged intents are needed for a slash-command-based ticket system.
4. 4Open OAuth2 > URL Generator. Select scopes: bot and applications.commands.
5. 5Under Bot Permissions, check: Manage Channels, Manage Roles, Send Messages, Read Message History, Add Reactions.
6. 6Copy the generated URL and invite the bot to your server.
7. 7Create a category in your server where ticket channels will be created — note its category ID from the channel URL.
8. 8Store DISCORD_BOT_TOKEN, DISCORD_GUILD_ID, DISCORD_SUPPORT_ROLE_ID, and DISCORD_TICKET_CATEGORY_ID in environment variables.

1import os
2import requests
3
4BOT_TOKEN = os.environ["DISCORD_BOT_TOKEN"]
5BASE_URL = "https://discord.com/api/v10"
6
7headers = {
8    "Authorization": f"Bot {BOT_TOKEN}",
9    "Content-Type": "application/json"
10}
11
12# Verify credentials
13resp = requests.get(f"{BASE_URL}/users/@me", headers=headers)
14resp.raise_for_status()
15print(f"Bot authenticated: {resp.json()['username']}")

Key endpoints

1{"name":"ticket-johndoe-0042","type":0,"parent_id":"1234567890","topic":"Support ticket for JohnDoe","permission_overwrites":[{"id":"111111111111","type":0,"allow":"0","deny":"1024"},{"id":"222222222222","type":1,"allow":"1024","deny":"0"},{"id":"333333333333","type":0,"allow":"1024","deny":"0"}]}

1{"id":"987654321098","type":0,"name":"ticket-johndoe-0042","guild_id":"555555555555","parent_id":"1234567890","position":42,"permission_overwrites":[{"id":"111111111111","type":0,"allow":"0","deny":"1024"},{"id":"222222222222","type":1,"allow":"1024","deny":"0"}]}

1{"content":"<@222222222222> Your ticket has been created. Support staff will be with you shortly.","embeds":[{"title":"Support Ticket #0042","description":"Please describe your issue in detail.","color":5814783}]}

1{"id":"112233445566","channel_id":"987654321098","author":{"id":"bot_id","username":"SupportBot"},"content":"<@222222222222> Your ticket has been created.","timestamp":"2026-05-07T10:00:00.000Z"}

1{"id":"987654321098","type":0,"name":"ticket-johndoe-0042","guild_id":"555555555555"}

Step-by-step automation

1# Register the slash command globally (takes up to 1 hour to propagate)
2curl -X POST \
3  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
4  -H "Content-Type: application/json" \
5  -d '{"name":"ticket","description":"Open a support ticket","type":1}' \
6  "https://discord.com/api/v10/applications/$APP_ID/commands"

1curl -X POST \
2  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d "{
5    \"name\": \"ticket-$USER_ID\",
6    \"type\": 0,
7    \"parent_id\": \"$CATEGORY_ID\",
8    \"permission_overwrites\": [
9      {\"id\": \"$GUILD_ID\", \"type\": 0, \"allow\": \"0\", \"deny\": \"1024\"},
10      {\"id\": \"$USER_ID\", \"type\": 1, \"allow\": \"3072\", \"deny\": \"0\"},
11      {\"id\": \"$SUPPORT_ROLE_ID\", \"type\": 0, \"allow\": \"3072\", \"deny\": \"0\"}
12    ]
13  }" \
14  "https://discord.com/api/v10/guilds/$GUILD_ID/channels"

1curl -X POST \
2  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d "{
5    \"content\": \"<@$USER_ID> Thanks for opening a ticket! Support will be with you shortly.\",
6    \"embeds\": [{
7      \"title\": \"Support Ticket\",
8      \"description\": \"Please describe your issue below.\",
9      \"color\": 5814783,
10      \"footer\": {\"text\": \"Ticket ID: $TICKET_NUMBER\"}
11    }]
12  }" \
13  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages"

1curl -X DELETE \
2  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
3  "https://discord.com/api/v10/channels/$CHANNEL_ID"

Complete working code

This script implements a complete ticket lifecycle: slash command registration, ticket creation with correct permission overwrites, welcome message posting, and channel deletion on close. It maintains a ticket counter in memory (replace with a database in production) and handles rate limits with backoff.

1import os, time, random, logging, requests
2
3logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
4
5BOT_TOKEN = os.environ["DISCORD_BOT_TOKEN"]
6GUILD_ID = os.environ["DISCORD_GUILD_ID"]
7SUPPORT_ROLE_ID = os.environ["DISCORD_SUPPORT_ROLE_ID"]
8CATEGORY_ID = os.environ["DISCORD_TICKET_CATEGORY_ID"]
9BASE = "https://discord.com/api/v10"
10HEADERS = {"Authorization": f"Bot {BOT_TOKEN}", "Content-Type": "application/json"}
11
12ticket_counter = 0
13
14def api_call(method, path, **kwargs):
15    for attempt in range(5):
16        resp = requests.request(method, f"{BASE}{path}", headers=HEADERS, **kwargs)
17        if resp.status_code == 429:
18            wait = resp.json().get("retry_after", 1) + random.uniform(0, 0.3)
19            logging.warning(f"Rate limited, sleeping {wait:.2f}s")
20            time.sleep(wait)
21            continue
22        return resp
23    raise RuntimeError("Max retries exceeded")
24
25def open_ticket(user_id: str) -> dict:
26    global ticket_counter
27    ticket_counter += 1
28    num = ticket_counter
29
30    # Create private channel
31    channel_resp = api_call("POST", f"/guilds/{GUILD_ID}/channels", json={
32        "name": f"ticket-{num:04d}",
33        "type": 0,
34        "parent_id": CATEGORY_ID,
35        "permission_overwrites": [
36            {"id": GUILD_ID, "type": 0, "allow": "0", "deny": "1024"},
37            {"id": user_id, "type": 1, "allow": "3072", "deny": "0"},
38            {"id": SUPPORT_ROLE_ID, "type": 0, "allow": "3072", "deny": "0"}
39        ]
40    })
41    channel_resp.raise_for_status()
42    channel = channel_resp.json()
43    channel_id = channel["id"]
44    logging.info(f"Created ticket channel {channel['name']} ({channel_id})")
45
46    # Post welcome message
47    msg_resp = api_call("POST", f"/channels/{channel_id}/messages", json={
48        "content": f"<@{user_id}> Your ticket has been created. Support will be with you shortly.",
49        "embeds": [{
50            "title": f"Support Ticket #{num:04d}",
51            "description": "Please describe your issue in detail.",
52            "color": 5814783,
53            "footer": {"text": "Use /close to close when resolved"}
54        }]
55    })
56    msg_resp.raise_for_status()
57    logging.info(f"Welcome message sent to {channel_id}")
58    return channel
59
60def close_ticket(channel_id: str) -> None:
61    resp = api_call("DELETE", f"/channels/{channel_id}")
62    if resp.status_code in (200, 404):
63        logging.info(f"Ticket channel {channel_id} closed")
64    else:
65        resp.raise_for_status()
66
67if __name__ == "__main__":
68    test_user_id = "123456789012345678"
69    channel = open_ticket(test_user_id)
70    logging.info(f"Ticket opened: {channel['name']}")
71    time.sleep(5)
72    close_ticket(channel["id"])
73

Error handling

Rate Limits for Discord API

1import time, random
2
3def rate_limited_request(method, url, headers, json_body=None, max_retries=5):
4    import requests
5    for attempt in range(max_retries):
6        resp = requests.request(method, url, headers=headers, json=json_body)
7        remaining = int(resp.headers.get('X-RateLimit-Remaining', 1))
8        if resp.status_code == 429:
9            wait = resp.json().get('retry_after', 1) + random.uniform(0, 0.5)
10            time.sleep(wait)
11            continue
12        if remaining == 0:
13            reset_after = float(resp.headers.get('X-RateLimit-Reset-After', 1))
14            time.sleep(reset_after)
15        return resp
16    raise RuntimeError('Max retries exceeded')

• Implement a ticket queue during peak hours — do not create channels concurrently from multiple users at the same time.
• Add anti-spam: limit each user to one open ticket at a time by checking if a channel named ticket-{userId} already exists.
• Read X-RateLimit-Remaining on every response and pause when it reaches 0.
• Separate ticket creation (REST) from interaction acknowledgment (interactions endpoint is rate-limit exempt) — always ack the interaction first.
• Store open ticket channel IDs in a database mapped to user IDs to prevent duplicate ticket creation and enable proper close logic.

Security checklist

Automation use cases

No-code alternatives

Don't want to write code? These platforms can automate the same workflows visually.

Best practices

• Always use the guild ID (not a hardcoded string) as the @everyone overwrite ID — they are identical by design.
• Pass permission bitmasks as strings, not integers — the Discord API is strict about this and will return a 400 with a cryptic error otherwise.
• Ack the slash command interaction immediately with deferReply (or a 202 Accepted) before creating the channel — channel creation can take a few hundred milliseconds and will miss the 3-second ack deadline.
• Store the ticket channel ID and creator user ID in a database — this enables lookup for /close commands and prevents users from closing others' tickets.
• Test permission overwrites by logging in as a non-support user and verifying the channel is invisible — it's the most common setup mistake.
• Set a ticket category channel to have explicit bot permissions so that inheriting from the parent category doesn't silently block the bot.
• Implement an auto-close mechanism: after 48 hours of inactivity (no messages), send a warning and close after another 24 hours.

Ask AI to help

Copy one of these prompts to get a personalized, working implementation.

Related automations

Explore related guides

Guides from other topics that help with this issue