// bots▮

BUILD BOTS FOR VOID

A bot is a small program that does work for you inside Void servers. It sends messages, adds reactions, moderates members and answers slash commands and buttons. Even someone who has never used an API can start: post with a single webhook URL, take full control with a little code, or build a no-code flow inside the app.

▶ Read the full API docs quickstart →

// where to start

simplest

Incoming webhook

> Even if you never code

POST to one URL and a message appears in a channel. No bot, no token.

In Server Settings > Webhooks, create a webhook bound to a text channel.
Copy the URL it gives you (the secret is inside the URL).
POST a message to that URL from any script.

full control

Bot with the REST API

> Your program sends and reads messages

Your own program talks to Void: send, read, react and moderate.

In the desktop app, open Settings > Developer, create an app and copy the token.
Ask a server admin to install your bot into their server.
Have your program call the API (see the 3 steps below).

no code

No-code flows

> No programming at all

Build automations inside the app by connecting blocks. Not a line of code.

Open Settings > Developer in the app.
Pick a trigger and steps (e.g. a welcome message when someone joins).
Publish it and let Void run it.

// send your first message in 3 steps

Hello, world

In the Void desktop app open Settings > Developer, create an app and copy the token. The token is shown once, so copy it then.
Ask a server admin to install your bot into their server and note a channel id.
Run the command below (swap in your CHANNEL_ID and token).

bashsend a message

curl -X POST https://api.thevoidhub.com/bot/v1/channels/CHANNEL_ID/messages \
  -H "Authorization: Bearer void_app_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"Hello from my bot!"}'

You get the created message back:

jsonresponse

HTTP/1.1 201 Created

{
  "message": {
    "id": "b4d7e9a1-3c25-4f80-9d16-5e7a8b9c0d1e",
    "channelId": "CHANNEL_ID",
    "authorId": "bot_a1b2c3",
    "body": "Hello from my bot!",
    "createdAt": "2026-08-25T12:00:00.000Z"
  }
}

> Even simpler: a webhook (no bot needed)

A server admin creates a webhook for a channel in Server Settings > Webhooks and hands you a URL. Anything that POSTs to it drops a message in the channel. No token, no install.

bashwebhook

curl -X POST https://api.thevoidhub.com/hooks/ID/TOKEN \
  -H "Content-Type: application/json" \
  -d '{"text":"Build finished ✅"}'

▶ Read the full API docs

// faq

> I do not code. Can I still make a bot?

Yes. The easiest path is an incoming webhook: you POST to a URL and a message appears in the channel. Or use no-code flows in the app to build automations without writing a line of code.

> Where do I get a token?

In the desktop app, Settings > Developer, create an app and it gives you a token. The token is shown once, so save it somewhere safe.

> Why can my bot not do anything?

A bot has to be installed into a server by that server admin before it can act there. The install decides what the bot is allowed to do (its permissions).