Developers

Adding your bot to DiscordForge is simple and takes less than 2 minutes.

Keep your users updated directly from your bot's profile page.

• Visibility: Announcements appear at the top of your bot's profile.
• Markdown: Full Markdown support including links, lists, and code blocks.
• One at a time: Each new announcement overwrites the previous one.

Show off your bot's status on your website or GitHub README.

We offer a robust REST API for posting stats and fetching bot data. Use our official SDKs for the best experience.

await fetch('https://discordforge.org/api/v1/bots/stats', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_BOT_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ server_count: 1500, shard_count: 5 })
});

{
  "server_count": 1500,
  "shard_count": 5,
  "user_count": 120000,
  "voice_connections": 12
}

{
  "hasVoted": true,
  "votedAt": "2026-05-03T08:42:11.000Z",
  "nextVoteAt": "2026-05-03T16:42:11.000Z"
}

{
  "id": "...",
  "name": "Forge Bot",
  "prefix": "/",
  "shortDescription": "...",
  "avatar": "...",
  "voteCount": 1240,
  "serverCount": 5300,
  "tags": ["moderation", "utility"],
  "owner": { "id": "...", "name": "..." }
}

{
  "commands": [
    {
      "name": "ban",
      "description": "Ban a user",
      "usage": "/ban <user> [reason]",
      "category": "Moderation"
    }
  ]
}

{
  "success": true,
  "message": "Heartbeat recorded successfully",
  "status": "online",
  "uptimeChecks": 5409,
  "uptimeOnline": 5409
}

{
  "canBump": false,
  "cooldownExpiresAt": "2026-05-05T20:30:00.000Z",
  "tierLabel": "FORGE",
  "cooldownMs": 1800000
}

{
  "shortDescription": "Moderation tools with clear review queues.",
  "tags": "moderation, utility",
  "website": "https://example.com",
  "webInterface": true
}

{
  "title": "v2.4.0: Scheduled reminders",
  "content": "Added recurring reminders and improved /remind.",
  "type": "UPDATE"
}

DiscordForge automatically detects your bot's status if it shares a server with the Forge bot. Forge is a public bot, so you can invite it to any server your bot is already in and uptime checks kick in automatically.

Why is my bot showing as offline?

It's almost always one of two things:

Still stuck after both? Ping staff with your bot's invite link and we'll take a look.

Set a custom vanity URL for your bot or server profile, making it easier to share and remember. Available to FORGE subscribers and PIONEER rank holders.

Vote webhooks fire whenever a user upvotes your bot on DiscordForge. Use them to reward voters instantly: grant a Discord role, unlock a premium feature, or DM a custom message. The reward flow is the #1 driver of recurring votes – bots that wire it up see 4x higher repeat votes than bots that don't.

Request

{
  "id": "123456789012345678",
  "username": "voteruser",
  "weeklyVotes": 42,
  "totalVotes": 150,
  "isTest": false
}

Expected response

Security

Examples

import express from 'express';
import crypto from 'crypto';

const app = express();
app.use(express.json());

const FORGE_WEBHOOK_SECRET = process.env.FORGE_WEBHOOK_SECRET;

app.post('/webhooks/forge-vote', (req, res) => {
    // 1. Verify the secret in the Authorization header
    const auth = req.headers.authorization;
    if (auth !== FORGE_WEBHOOK_SECRET) {
        return res.status(401).json({ error: 'Invalid secret' });
    }

    // 2. Parse the payload
    const { id, username, weeklyVotes, totalVotes, isTest } = req.body;

    // Skip test events in production handlers
    if (isTest) {
        console.log('Received test webhook for', username);
        return res.status(200).json({ ok: true });
    }

    // 3. Reward the user (example: grant a Discord role for 12h; role duration is intentionally longer than the 8h vote cooldown)
    grantVoterRole(id);

    // 4. Acknowledge within 5 seconds – non-2xx triggers retries (3 attempts)
    return res.status(200).json({ ok: true });
});

app.listen(3000, () => console.log('Webhook listener on :3000'));

Get real-time Discord notifications whenever someone votes for your bot.