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.

    https://discord.com/api/oauth2/authorize?client_id=1538104548210643015&permissions=268436480&scope=bot+applications.commands
    Open invite link
  • Using 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.

Ready when you are

Start your first project

Create a project