Webhook Event Reference for FBL

FBL webhooks deliver two event types: upvote, fired when a user votes for your project, and test, sent when you trigger a test from the dashboard. Both events share the same payload shape.

upvote

FBL fires this event each time a user upvotes your bot or server. Use it to reward voters, update leaderboards, or log activity.

Field	Type	Description
type	string	Always "upvote"
bot_id	string	Your bot's Fluxer ID (bots only)
server_id	string	Your server's Fluxer guild ID (servers only)
user_id	string	Fluxer user ID of the voter
weight	number	Vote weight (currently always 1)
created_at	string	ISO 8601 timestamp when the vote was cast
expires_at	string	ISO 8601 timestamp when the user can vote again
is_weekend	boolean	Reserved for a future weekend multiplier (currently false)
query	string	The vote page's query string, without the ? (may be empty). Link people to fbl.gg/bots/<id>/vote?ref=discord and you get ref=discord.

Example payload:

{
  "type": "upvote",
  "bot_id": "803190510032756736",
  "user_id": "160105994217586689",
  "weight": 1,
  "created_at": "2026-04-23T14:22:00.000Z",
  "expires_at": "2026-04-24T02:22:00.000Z",
  "is_weekend": false,
  "query": ""
}

A server vote looks the same, with server_id instead of bot_id:

{
  "type": "upvote",
  "server_id": "1494802332096701791",
  "user_id": "160105994217586689",
  "weight": 1,
  "created_at": "2026-04-23T14:22:00.000Z",
  "expires_at": "2026-04-24T02:22:00.000Z",
  "is_weekend": false,
  "query": ""
}

test

FBL sends this payload when you click Send Test on your bot's or server's API dashboard. It's identical in shape to upvote but with type set to "test" so you can branch on it and skip the voter-reward logic during testing.

{
  "type": "test",
  "bot_id": "803190510032756736",
  "user_id": "160105994217586689",
  "weight": 1,
  "created_at": "2026-04-23T14:22:00.000Z",
  "expires_at": "2026-04-24T02:22:00.000Z",
  "is_weekend": false,
  "query": ""
}