Installation
How to add the bot
Use the Add Bot or Add KeyHub to Discord link on the main site. Authorize KeyHub for your server and complete the Discord OAuth flow. The bot will join your server.
Required permissions
The bot needs permission to:
- View channels and send messages (to post the key embed and log redemptions).
- Manage roles (to assign the VIP role when a key is redeemed).
- Create channels (optional; if you use
/setupand choose to have the bot create the key and log channels, it will create an “Access” category and channels).
Ensure the bot’s role is above the role you want to assign (e.g. VIP) in the server’s role list. Otherwise it cannot assign that role.
What happens after install
The bot operator receives a notification when you add the bot and must approve your server (and, in subscription mode, set a duration). Until then, slash commands that depend on approval will respond with a “pending approval” message. After approval, run /setup to configure the key channel, log channel, key link, and VIP role.
Until setup is complete (key link and VIP role set, and “Post” used), the key redemption embed will not appear in your server.