Connect Roblox Cloud

Roblox Creator OAuth lets Clan Labs read community roles and pending joins, change eligible ranks, and decide join requests. Member verification selects a person's Roblox identity; this connection authorizes community operations. Your integrations still use their own Clan Labs API keys.

See the Roblox ranking workflow for how this connection supports staff rank actions and progression.

Before you startCopy link to Before you start

Create the main community or division first. You must be its Discord server owner (Super Owner) and be able to complete fresh Discord verification. The Roblox account must retain permission to manage roles and pending joins for the target community.

Connect the communityCopy link to Connect the community

1. Open Settings → Roblox Cloud.
2. Complete Verify Discord to continue if requested.
3. Choose Connect Roblox when available.
4. Check the account and target community on Roblox's consent screen, then authorize access.
5. Return to Clan Labs and check the connected-account card.

Use a dedicated organization-managed Roblox account with two-step verification and secure recovery details. Clan Labs encrypts the tokens and refreshes them automatically. Never share tokens, keys, or browser sessions.

Check the resultCopy link to Check the result

Connected Roblox account should show Active. Open Pending Join Requests or test an authorized rank change on a test member, then check Roblox and the audit entry. Inspect current state before retrying a timed-out write.

The card can show the display name, username, account creation date, View profile, and an OAuth account ID. That ID identifies the authorization; it is not a substitute for global Roblox user IDs. Missing profile details alone do not mean the connection failed.

Clan Labs requests group:read and group:write for community operations, plus openid and profile for the connected account's profile details.

Manage the connectionCopy link to Manage the connection

Switch or reconnectCopy link to Switch or reconnect

Choose Switch account, review the replacement, then Continue with Roblox. Complete Discord verification if requested and authorize the intended account and community. Check the returned card before resuming operations.

Use that account action when the card shows Requires reauthorization, or Reconnect Roblox where offered. An automatic refresh or temporary service failure may recover without reconnecting. For status-specific recovery, see Roblox connection errors.

Disconnect RobloxCopy link to Disconnect Roblox

Choose Disconnect Roblox, verify with Discord if required, and confirm. Roblox rank and pending-join operations stop immediately. If provider revocation cannot finish, the encrypted refresh token is retained only for the pending revocation retry. Wait for that cleanup before reconnecting.

Disconnecting this integration does not unlink members' verified accounts. Manage those through Linked Roblox accounts.

Temporary legacy API keysCopy link to Temporary legacy API keys

Use this flow only when Creator OAuth is unavailable, legacy access is enabled, and no OAuth grant exists. A failed OAuth connection does not fall back to a saved key. Follow the migration notice shown for your community.

When Temporary API key or Replace temporary API key appears:

1. Choose Create API key in Roblox to open Roblox Credentials.
2. Under User API Keys, create a dedicated, descriptively named key.
3. Add the groups API system and select the target Community ID shown by Clan Labs. If it is unavailable, correct the Roblox account's community permissions.
4. Select group:read and group:write.
5. Leave IP restrictions empty. Set an expiry only if you can replace the key before then.
6. Copy the secret into Roblox Open Cloud API key and choose Save API key or Replace API key.

The secret is not displayed again. Remove temporary copies and revoke obsolete keys on Roblox. Use Remove API key for a disabled stored key; clearing an active key stops operations until you connect again.

If no connection option is available, follow Roblox connection troubleshooting.