Skip to main content

​
Getting Started with Invaro

1

Invite Invaro Bot to Your Server

Invite the Invaro Bot to your Discord server by clicking the OAuth2 URL.
Ensure the bot has Administrator permissions or at minimum: Manage Roles, Manage Nicknames, View Channels, and Send Messages.
2

Create Your Portal

Go to the Invaro Dashboard, log in with Discord, and click “Create Portal”.
​
select
required
Select the Discord server this portal will manage. You must have the “Server Administrator” permission to create a portal for a server.Example: Invaro Systems
​
select
required
Select your Roblox Group you want to manage.Example: Invaro
​
string
required
Choose a descriptive name for your portal. This will be displayed in the dashboard and logs.Example: Invaro Systems Portal
​
string
Optional description to help you identify the portal’s purpose.Example: Powering Professional Roblox Communities
3

Configure Portal Settings

After creating your portal, navigate to the Settings tab to configure essential options:
​
toggle
default:"false"
Automatically verify users when they join the linked Discord server based on their Roblox account.
Users must have previously linked their Roblox account.
​
toggle
default:"false"
Allow Discord server administrators to manage this portal without being the owner.
Gives server admins full access to portal settings. Only the portal owner can toggle this setting.
​
string
Default nickname template applied to all users portal-wide. Individual bind nicknames will override this.Example: {displayName} (@{username})Available Variables:
  • {username} - User’s Roblox username
  • {displayName} - User’s Roblox display name
  • {smartName} - Display name if set, otherwise username
  • {userId} - User’s Roblox user ID
  • {groupRank} - Their rank in your group
  • {groupRole} - Their role name in your group
Leave empty to not modify nicknames. Bind-specific nicknames take priority.
​
role
required
Role assigned to verified users.Example: @VerifiedThis role is automatically given when a user successfully verifies their Roblox account.
​
role
required
Role assigned to unverified users.Example: @UnverifiedThis role is automatically given to users who haven’t verified yet.
4

Connect Roblox OAuth (Recommended)

For full functionality including automatic ranking and group management, connect your Roblox account via OAuth:
  1. In the Settings tab, click “Connect Roblox Account”
  2. You’ll be redirected to Roblox to authorize Invaro Systems - Portals
  3. Review the permissions (scopes) you want to grant
  4. Approve the authorization
OAuth is the secure method for connecting your Roblox account. It can be revoked anytime from the Roblox website. Only the portal owner can connect or unlink a Roblox account.
​
scope
required
Basic identity information needed for all portal operations.
​
scope
required
Allows Invaro to read group memberships and verify users are in your group.
​
scope
Enables automatic ranking features (promote/demote users). Required for ranking commands.
If your Roblox token expires, ranking and group management will stop working. Re-authorize from the Settings tab to restore access.
5

API Key for In-Game Ranking

Invaro+ and Invaro+ Boost customers receive an API key for use with in-game ranking systems and external integrations.
Invaro+ Feature: API keys are available on Invaro+ and Invaro+ Boost plans. API URLs are available on Invaro+ Boost only.
​
string
Automatically generated API key for your portal. Only visible to the portal owner.Example: INVARO_****************_SYSTEMS_****************_KEYUse Cases:
  • In-game ranking commands
  • In-game logging system
  • Custom integrations (Invaro+ Boost)
  • Automated workflows
​
button
Click “Regenerate Key” to create a new key and invalidate the old one.
This action is immediate and cannot be undone. Any systems using the old key will stop working. Update your integrations immediately after regeneration.
When to regenerate:
  • Key has been compromised or exposed
  • Offboarding a developer who had access
  • Regular security maintenance (every 90 days recommended)
​
info
Security Best Practices:
  • Never share API keys publicly
  • Rotate keys regularly (every 90 days)
  • Immediately regenerate if compromised
Your API key is only shown to you (the portal owner). Not even Invaro staff can see it. Keep it secure!
6

Save Your Configuration

Click “Save Changes” at the top of the settings page to apply your configuration.
Your portal is now created! Next, you’ll want to set up role bindings and permissions.

​
Alternative Owners

You can grant additional users full portal access without transferring ownership. Alternative owners have the same permissions as the portal owner, with two exceptions: they cannot delete the portal and cannot manage other alternative owners. To add an alternative owner, navigate to Settings and enter the user’s Discord user ID in the Alternative Owners section.
To find a Discord user ID, right-click the user in Discord and select Copy User ID. Developer Mode must be enabled in Discord settings.

​
Need Help Finding Information?

OAuth Setup Guide

Detailed OAuth configuration and troubleshooting

Bot Permissions Setup

Ensure the Invaro bot as Administrator permissons

​
Next Steps

After completing the initial setup, continue with these guides:
1

Configure Role Bindings

Set up automatic role assignment based on Roblox group ranks, asset ownership, or group membership.Learn about Binds →
2

Set Up Portal Roles

Define who can manage your portal by configuring permission and access roles.Configure Portal Roles →
3

Test Your Setup

Verify your portal is working correctly by testing the Invaro bot in your Discord server.

​
Important Security Guidelines

  • Ensure bot roles are positioned correctly in Discord’s role hierarchy
  • The bot cannot assign roles higher than its own highest role
  • Grant only necessary permissions to minimize security risks
  • Regularly audit who has portal management access
  • OAuth: Secure method for connecting Roblox accounts
  • API Keys: Keep your API keys confidential and rotate them regularly
  • Never share credentials: Invaro staff will never ask for your credentials
  • Invaro does not have access to your API keys or OAuth refresh tokens
  • All credentials are encrypted at rest in our database
  • You can revoke OAuth access at any time from the Roblox website
  • Review our Privacy Policy for details
To delete your portal:
  1. Navigate to Settings in your portal dashboard
  2. Scroll to the Danger Zone section and click “Delete Portal”
  3. Type your portal name to confirm
  4. Click “Delete Portal”
This action is permanent and cannot be undone! All binds, roles, and configuration will be lost. Only the actual portal owner can delete a portal — alternative owners cannot.

​
Subscription Plans

Your portal capabilities depend on your subscription tier:
$0 / foreverPerfect for getting started with InvaroFeatures:
  • 1 Portal
  • 2 Alternative Owners
  • Ticket Boards (3 boards, 2 categories per board)
  • Verification System
  • Role Binding System
  • Announcement System
  • Rank Management
  • Team Directory Access
  • Portal Audit Logs
  • Triggers
  • Member Stream
Upgrade your plan → to unlock additional features. Purchase through our Discord server.

​
Getting Help

If you encounter issues during setup:
Invaro+ and Invaro+ Boost subscribers receive priority support with faster response times.