Quickstart - Hansel Bot API

1. Invite the Bot

Add Hansel Bot to your Discord server using the invite link below. Replace BOT_ID with the bot’s Discord ID.

https://discord.com/oauth2/authorize?client_id=BOT_ID&permissions=0&scope=bot%20applications.commands

You can find available bot instances and their IDs on the dashboard or via the List Bots endpoint.

Once you click the link, select the server you want to add the bot to and authorize it. The bot will appear in your server’s member list.

Hansel Bot uses a code-based login system through Discord DMs.

Request a code

Go to the dashboard and enter your Discord ID or username to request a login code.This calls the API behind the scenes:

curl -X POST https://hapi.7331.org/v1/authentication/request \
  -H "Content-Type: application/json" \
  -d '{"discord_id": 123456789012345678}'

Get the code from Discord

Use the /login slash command in any server where Hansel Bot is present. The bot will DM you your 8-character login code.

Verify

Enter the code on the dashboard (or call the API directly) to complete login.

curl -X POST https://hapi.7331.org/v1/authentication/verify \
  -H "Content-Type: application/json" \
  -d '{"code": "ABCD1234"}'

On success, a session cookie is set and you’re logged in.

Once logged in, you can: