SimpleLinks Docs

Custom Bot

Run the verification flow under your own Discord bot — your bot's name, avatar, and presence on every link page. SimpleLinks keeps doing the work; only the face changes.

$5 / month per Discord server. Billed through Stripe. Cancel anytime — verification falls back to the shared platform bot the moment the subscription ends.

What you get

  • Verification, role grants, nickname sync, and Nitro checks all execute under your bot token.
  • Your bot shows up in audit logs as the actor — not the platform bot.
  • You retain full ownership of the Discord application: permissions, presence, command surface, status message.
  • Token is encrypted at rest with AES-GCM. The plaintext never lands on disk.

Setup — five minutes

1. Subscribe

Dashboard → Guild → Custom BotSubscribe — $5 / month. You'll be sent to Stripe Checkout. After payment, you land back on the bot page with the token form unlocked.

2. Create the Discord application

Open the Discord Developer Portal and create a new application. Under Bot, click Reset Token and copy the value. Under OAuth2 → Bot → Privileged Gateway Intents, leave everything off — SimpleLinks does not use gateway intents.

3. Paste & validate

Drop the token into the Custom Bot card and hit Validate. We call GET /users/@me to confirm the token is alive and to capture the bot's identity (user id, username, avatar, application id).

4. Invite the bot

The validation step returns a pre-filled invite URL scoped to this Discord server with the exact permissions needed: CREATE_INSTANT_INVITE, MANAGE_ROLES. Open the link, authorize, done.

5. Save

Click Save & Enable. From this point every Discord call SimpleLinks makes for this Guild uses your token. The status card shows the live "bot is in server" check — refresh it any time.

Required Discord permissions

PermissionWhy
MANAGE_ROLESGrant and revoke the Verified role and Nitro role.
CREATE_INSTANT_INVITEAuto-join users who don't already share the server.
CHANGE_NICKNAME / MANAGE_NICKNAMESOptional — only if you enable Nickname Sync.

The bot's highest role must sit above the Verified and Nitro roles in your role hierarchy. Discord won't let any bot manage roles equal to or above its own.

Failure modes & fallback

  • Subscription expires. Custom bot is disabled, shared platform bot takes over on the next request — zero downtime.
  • Token revoked in Discord. Discord returns 401, the request fails. Reset the token in the Developer Portal and re-validate.
  • Bot leaves the server. Role operations 404. Re-invite via the same URL on the Custom Bot card.

Billing

Manage your subscription, payment method, and invoices from the Manage Billing button on the bot card — it opens a Stripe-hosted portal session.

Cancellation takes effect at period end. You keep custom-bot capability until the renewal date, after which it auto-reverts to the shared bot.