Apps & Integrations

Applications, bots, and authorizations

How to create an app, invite a bot, build an OAuth URL, and revoke access

1 min readUpdated for the current Astral app

Developer docs: docs.astraof.com. In the app: User Settings → Applications (the account must be claimed).

Create an application

  1. Give it a name (max 100 characters).
  2. On the app card: public bot or not, redirect URIs, copy the Application ID.
  3. Secrets: client secret and bot token. Regenerating them breaks existing integrations. Viewing them may require identity verification.

Bot profile: username, avatar, banner, About Me. A custom bot discriminator is available only if the owner is Visionary.

Deleting the application also destroys the bot user.

OAuth

The URL builder supports these scopes:

Scope Meaning
identify Basic profile
email Email address
guilds Communities the user belongs to
bot Add a bot with the requested permissions

applications.commands exists in constants but is filtered out of the builder today. A redirect URI is required unless the scope is bot-only.

Users revoke access in User Settings → Authorized AppsDeauthorize.

Webhooks without a bot

If you only need inbound posts into a channel, a webhook is enough: Community emoji, stickers, and webhooks.

Still need help?

If you couldn't find what you're looking for, our support team is here to help.

Contact Support
AI
AI Assistant
📚
Ask anything about Astral
Powered by Grok