Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/resynceddesign/giveawaybot/llms.txt

Use this file to discover all available pages before exploring further.

Use /gcreate to post a giveaway embed in any text or announcement channel. The bot sends an entry button alongside the embed, tracks clicks as entries, and automatically picks winners when the timer expires.

Parameters

prize
string
required
The name of the prize being given away. This becomes the title of the giveaway embed.
winners
integer
required
The number of winners to select when the giveaway ends. Must be a positive integer.
duration
string
required
How long the giveaway runs. Use the format <number><unit> — for example 30m, 2h, or 1d. See the duration units table below.
channel
channel
The text or announcement channel to post the giveaway in. When omitted, the giveaway is posted in the channel where you ran the command.

Duration format

UnitMeaningExample
sSeconds90s
mMinutes30m
hHours2h
dDays1d
The value must be a whole number followed immediately by one of these unit characters, with no spaces (e.g. 2h, not 2 h or 2 hours).

Example

/gcreate prize:Nintendo Switch winners:1 duration:2d channel:#giveaways
/gcreate prize:Discord Nitro winners:3 duration:30m

Behavior

When the command runs successfully, the bot:
  1. Posts an embed in the target channel with the prize name as the title, a countdown timestamp, the host’s mention, and the winner count in the footer.
  2. Attaches an entry button styled with the server’s configured emoji. Members click this button to enter.
  3. Sends you an ephemeral confirmation (“Giveaway started in #channel-name”).
  4. Records the giveaway in the database and automatically picks winners once the duration elapses.
If the channel option points to a channel that is not a text or announcement channel, the command responds with an ephemeral error and no giveaway is created.
The bot must have Send Messages and Embed Links permissions in the target channel. Without these, the giveaway post will fail.

Build docs developers (and LLMs) love