Connect Roblox Open Cloud

What this doesCopy link to What this does

Roblox Open Cloud authorises supported Roblox community writes, including rank changes and pending-join decisions. The credential is separate from a Clan Labs API key.

PrerequisitesCopy link to Prerequisites

• The main community or division already exists in Clan Labs.
• You are the Discord server owner; Clan Labs reserves Roblox Cloud configuration for Super Owner.
• The Roblox account creating the key can grant Open Cloud access to the target community.
• You can reauthenticate with Discord before saving or removing a credential.

Setup stepsCopy link to Setup steps

1. Open the Clan Labs community.
2. Go to Settings → Roblox Cloud.
3. Choose Credential instructions and verify the displayed target Community ID.
4. Open Roblox Credentials.
5. Under User API Keys, choose Create API Key.
6. Use a descriptive name such as Clan Labs (COMMUNITY_NAME).
7. Add the groups API system for the target community.
8. Select both group:read and group:write.
9. Leave IP restrictions empty. Add an expiry only if you will replace the key before that date.
10. Choose Save & Generate, copy the key once, and paste it into Clan Labs.
11. Choose Save credential.

Expected resultCopy link to Expected result

The status changes to Configured and shows the last time Clan Labs validated or updated the credential. The secret itself is never shown again.

Verify that it worksCopy link to Verify that it works

Open Pending Join Requests or perform an authorised low-risk rank operation. The page should load or the action should complete without an Open Cloud precondition error. Confirm the correct Roblox state and audit entry afterward.

Common errorsCopy link to Common errors

• No Roblox Open Cloud credential is configured — save a key before using write workflows.
• Roblox rejects validation with 401 or 403 — generate a current key and confirm both required scopes and the target community.
• The community is absent in Creator Hub — use an eligible Roblox account or fix its role permissions.
• A request works initially and later fails — check key expiry or whether the key was revoked.
• Rank or join writes time out — do not assume they failed; refresh Roblox state before retrying.

Security practicesCopy link to Security practices

• Create a dedicated key instead of reusing one from another service.
• Grant only the groups system and the two required scopes for the intended community.
• Do not restrict the key to your device’s IP.
• Do not share the secret in Discord, screenshots, logs, source control, or support requests.
• Replace the credential immediately if it may have been exposed. Clan Labs clears pasted drafts when fresh reauthentication expires.

Next, configure verification and group and rank binds.