Webhooks

Webhooks let you pipe application events to anything that accepts an HTTP POST. Per-application config: one URL, plus a list of events to fire on.

How to enable#

1. Open the application editor.
2. Switch to the Webhooks tab.
3. Paste your HTTPS URL.
4. Pick which events should fire (submitted, accepted, denied, expired, cancelled).
5. Save.

Payload shape#

json
{
  "event": "accepted",
  "timestamp": "2026-05-04T20:00:00.000Z",
  "guild": { "id": "...", "name": "..." },
  "application": { "id": "...", "name": "Staff Application" },
  "submission": {
    "id": "...",
    "status": "accepted",
    "applicantId": "...",
    "applicantTag": "user#0001",
    "answers": [
      { "questionId": "...", "questionPrompt": "...", "questionType": "text", "answer": "..." }
    ],
    "timing": { "startedAt": "...", "submittedAt": "...", "decidedAt": "...", "timeTakenMs": 1234 },
    "review": { "reviewerId": "...", "reviewerTag": "...", "reason": "..." },
    "riskSnapshot": { "score": 80, "level": "low", "accountAgeDays": 365, "flags": [] }
  },
  "reviewer": { "id": "...", "tag": "..." }
}

Reliability#

Webhooks are fire-and-forget with one automatic retry on failure (5 second timeout). Consistent failures are logged on the bot but not retried beyond that. If you need guaranteed delivery, build a queue on your end that re-pulls from the dashboard.