Guide
How to use oxbot
Whether you're entering a drop or running one for your own community, here's the whole flow — start to finish.
Entering a giveaway
No project of your own needed — just sign in and complete the tasks.
Sign in
Sign in with Discord — it's the only way to create an account, and it verifies your identity across every giveaway automatically.
Complete the tasks
Each giveaway lists its own requirements — follow an account, join a Discord server, hold a role, enter a code. Statuses update live as you finish each one.
Your entry stays private
Only the project's own team can ever see who entered. Public pages never show entrant identities.
Check your wins
Random draws use a seeded CSPRNG (reproducible and auditable); FCFS rewards the fastest valid entries. See your history any time on your profile.
My wins →
1. Create your project
This is the home for your brand and every giveaway you run.
Sign in, then open your dashboard
Use the account you want to own the project — you'll be its Owner, with full control including who else can manage it.
Create a project →Invite your team
Under Members, invite teammates as Admin (manages members & settings) or Raffle Manager (runs giveaways without full admin access).
2. Connect your Discord server
Required before you can gate a giveaway on server membership or roles.
You'll need Manage Server permission
On the Discord server you want to connect — not on oxbot itself. Anyone with that permission on their own server can connect it.
Invite the oxbot bot
This is what checks server membership and roles when entrants complete Discord-gated tasks on the giveaway page.
Open invite linkhttps://discord.com/api/oauth2/authorize?client_id=1538104548210643015&permissions=268436480&scope=bot+applications.commandsUsing a security bot like Wick or Dyno?
Anti-nuke bots often auto-kick new bots by default — usually under a rule like "unverified bot additions" or "minimum account age." If oxbot vanishes right after joining, check its settings and whitelist oxbot, or lower/disable the rule that caught it.
Copy your server ID
In Discord: User Settings → Advanced → enable Developer Mode. Then right-click your server's icon → Copy Server ID.
Paste it into oxbot
Under your project's Settings (once, for all giveaways) or a specific giveaway's Project links (per giveaway) — paste the server ID into Discord server ID.
3. Create a giveaway
Three engines, and any combination of entry tasks.
Basics & format
Title, prize, description, banner. Pick Random Raffle, First-Come-First-Served, or Code-based — this can't be changed once entries exist.
Entry requirements
Add any combination: CAPTCHA, email, code, X follow/like/repost, Join Discord, or Hold a Discord role. For the two Discord tasks, click Load roles from Discord to pick real roles instead of typing IDs.
Visibility
Public (listed, anyone can enter), Community (gated to your Discord/Telegram), or Private (code-gated, shared directly — the only visibility that doesn't require a Discord server ID).
Project links
X account, Discord server ID, Telegram. The Discord server ID here is what every Discord-based requirement checks against.
4. How it runs in your Discord channel
Two separate jobs — a webhook that posts, and a bot that verifies.
Create a webhook for your giveaway channel
In Discord: open the channel you want giveaways posted to → Edit Channel → Integrations → Webhooks → New Webhook. Copy its URL.
Paste the webhook URL into oxbot
Under your project's Settings, paste it into Discord webhook URL. This is separate from the server ID used for gating — it only controls where announcements post.
Publishing posts it automatically
The moment a giveaway is published, oxbot posts an embed to that channel — title, prize, chain, format, banner, and a live countdown to when entries close. No manual copy-paste needed.
The bot verifies, it doesn't post
The oxbot bot you invited in step 2 has one job: when someone completes a Join Discord or Hold a role task on the giveaway page, it checks their membership/roles in your server in real time. It never posts messages or runs commands in Discord.
After you draw, announce winners yourself
oxbot doesn't auto-post or auto-DM winners to Discord today — draw them on the giveaway's dashboard, then share the results back into your channel (e.g. paste the giveaway link, which shows winners once you publish the draw).
5. Publish & manage
Everything after launch happens on the giveaway's dashboard page.
Entrants (private)
Only your team ever sees this list — full identity, per-task status, and a CSV export. Public pages never leak who entered.
Draw winners
Available once entry closes. Random Raffle draws are seeded and reproducible; FCFS just locks in the fastest valid entries. Re-roll any time for a fresh seeded draw.
Audit log
Every team mutation — giveaway changes, role changes, draws — is recorded for accountability.
Troubleshooting
Load roles from Discord shows an error
Either oxbot hasn't been invited to that server, or a security bot kicked it — see the anti-nuke note in step 2. You can still paste role IDs manually as a fallback.
"Set a Discord server ID" error when publishing
A Discord server ID is required for Public and Community giveaways. Either add one under Project links, or switch visibility to Private.
Sharing a giveaway link shows no image on Discord/WhatsApp
Set a banner on the giveaway — if it has none, a default branded image is used automatically, so this should be rare.