Getting Your API Key
How to generate and configure a Roblox Open Cloud API Key for the Audio Bulk Uploader.
To use the Roblox Audio Bulk Uploader, you must provide a Roblox Open Cloud API key. This key authorizes the application to upload audio files on your behalf.
Note on authentication: The use of .ROBLOSECURITY cookies is NOT supported and will not work. This application exclusively uses secure x-api-key header authentication via Roblox Open Cloud.
1. Creating the API Key
- Navigate to the Roblox Creator Dashboard.
- Go to Credentials in the left sidebar.
- Click on API Keys and then Create API Key.
Save your key immediately! The API key will only be shown to you once upon creation. If you lose it, you will need to regenerate a new key.
2. Required Scopes
When configuring the API key, you must assign the correct permissions (scopes):
- Asset:Write (Mandatory): Required to upload the audio files to Roblox.
- Asset:Read (Optional but Recommended): Necessary if you want the app to track the moderation status of your uploaded audio.
- Asset Permissions (Optional but Recommended): Necessary if you want the app to automatically grant universe/game permissions to the uploaded audio.
3. Configuring the Creator Type
The Creator Type field determines who will own the uploaded audio. You must match this to where you plan to use the audio:
- User: Select this if you are uploading audio for your personal experiences. The Creator ID will be your personal Roblox User ID.
- Group: Select this if you are uploading audio for a group experience. The Creator ID must be the exact Group ID of the target group.
4. Common Mistakes to Avoid
- Creating the key under the wrong creator: Ensure your Creator ID exactly matches the destination (User vs. Group) where you want the audio to go.
- Forgetting
Asset:Read: If you notice moderation tracking isn't working, double-check that this scope was included on your key. - Setting the wrong IP allowlist: If your key gets rejected immediately, verify your IP allowlist. We recommend leaving it open (e.g.,
0.0.0.0/0) during initial testing to ensure the app works, and locking it down to your specific IP address later.
5. Where to Paste Your Key
Once your key is generated and copied, open the Roblox Audio Bulk Uploader application.
Navigate to the Configuration panel and paste your key directly into the API Key field.
Next Step: Now that you have your API key, proceed to the Quickstart Guide to begin uploading.