Description

!Banner image

n8n-nodes-roblox

This project provides custom community nodes for n8n that integrate with the Roblox Open Cloud API. It allows you to connect your Roblox experience with automated workflows in n8n — including data access, place publishing, messaging, and more.

Features

• Community node package for n8n
• Built-in authentication with Open Cloud API keys
• Modular support for Roblox API endpoints
• Example nodes for querying and automating Roblox experiences
• Configs Open Cloud support for reading, staging, publishing, and restoring experience configs
• User subscription lookup support for subscription products
• Team Create Open Cloud support for settings, active sessions, team test shutdowns, and membership removal
• Storage Open Cloud support for data stores, memory store queues, memory store sorted maps, memory store flush operations, and ordered data stores
• Luau Execution Open Cloud support for creating tasks, polling task state, reading logs, and creating binary inputs
• Group Forum Open Cloud support for listing forum categories, posts, and comments
• Bans and Blocks Open Cloud support for universe-level and place-level user restrictions
• Assets Open Cloud support for uploading and updating assets from n8n binary data, versions, rollback, archive, and quotas (Beta)
• Place publishing from an .rbxl or .rbxlx binary file (Beta)
• Developer product and game pass management, including icon uploads (Beta)
• Server management for listing game servers, reading server logs, and forecasting and launching restarts (Beta)
• Analytics queries for metric time series and dimension values (Beta)
• Universe secrets management with built-in libsodium sealed-box encryption (Beta)
• User inventory lookups for ownership checks (Beta)

> ℹ️ Operations marked (Beta) in the node call Roblox endpoints that Roblox labels Beta. They work with API keys today, but Roblox may change them.

> ✅ Ideal for developers using Roblox + automation tools like n8n to build dashboards, pipelines, and custom tools.

Current Nodes and Arguments

• Roblox Cloud

– Analytics (Beta): operations querymetrics, querydimensionvalues, getmetricsoperation, getdimensionvaluesoperation. Arguments: universeId, operationId, analyticsMetric, analyticsStartTime, analyticsEndTime (times without an offset are treated as UTC), analyticsGranularity, analyticsDimensions (comma-separated), analytics_options (breakdown, filterJson, limit). Queries can return a long-running operation; poll it with the matching Get Operation call.
– Asset (Beta): operations createasset, updateasset, getasset, getassetoperation, listassetversions, getassetversion, rollbackassetversion, archiveasset, restoreasset, listassetquotas. Arguments: assetId, assetVersionNumber, operationId, userId, assetType (Animation, Audio, Decal, Image, Mesh, Model, Video), assetDisplayName, assetDescription, assetCreatorType, assetCreatorId, assetCreateOptions (assetPrivacy, expectedPrice), assetUpdateJson (metadata; the update mask is built from its keys), assetUpdateContent, binaryPropertyName, assetContentType, assetReadMask, assetversionsquery (maxPageSize, pageToken), assetquotaquery (filter, maxPageSize, pageToken). Create and Update return an operation; poll it with getassetoperation.: operations getconfigvalues, getconfigfull, getconfigdraft, updateconfigdraft, resetconfigdraft, overwriteconfigdraft, publishconfigdraft, listconfigrevisions, restoreconfigrevision. Arguments: universeId, repository, entriesJson, previousDraftHash, draftHash, publishMessage, deploymentStrategy, revisionId, configrevision_filters (endTime, maxPageSize, searchKey, skip, sortKey, sortOrder, startTime).
– Developer Product (Beta): operations createdeveloperproduct, getdeveloperproduct, listdeveloperproducts, updatedeveloperproduct. Arguments: universeId, productId, productName, productFields (name, description, price, isForSale, isRegionalPricingEnabled, isManagedPricingEnabled, storePageEnabled), productImageBinaryProperty, productlistquery (pageSize, pageToken).
– Engine: operation get_operation. Arguments: operationPath.
– Game Pass (Beta): operations creategamepass, getgamepass, listgamepasses, updategamepass. Arguments: universeId, gamePassId, productName, productFields (name, description, price, isForSale, isRegionalPricingEnabled, isManagedPricingEnabled), productImageBinaryProperty, productlistquery (pageSize, pageToken).
– Group: operations acceptjoinrequest, assignmemberrole, declinejoinrequest, getauditlog, getgroup, getgrouppolicies, getjoinrequests, getmanageablegroups, getmemberships, getpendinggroups, getrole, getroles, getsettings, listforumcategories, listforumcomments, listforumposts, unassignmemberrole, updatedescription, updatememberrole, updatenotificationpreference, updatesettings. Arguments: groupId, joinRequestId, membershipId, forumCategoryId, postId, userId, roleId, description, groupPolicyGroupIds, argumentsmemberships (maxPageSize, pageToken, filter), groupjoinrequestsquery (maxPageSize, pageToken, filter), grouprolesquery (maxPageSize, pageToken), groupforumcategoriesquery (maxPageSize, pageToken, filter), groupforumpostsquery (maxPageSize, pageToken, filter, view), groupforumcommentsquery (maxPageSize, pageToken, filter), groupauditlogquery (actionType, userId, limit, cursor, sortOrder), groupsettingsupdate, and groupnotification_preference.
– Luau Execution: operations createsessiontaskbinaryinput, createsessiontask, createsessiontaskforversion, getsessiontask, listsessiontasklogs. Arguments: universeId, placeId, versionId, luauExecutionSessionId, taskId, binaryInputSize, script, timeout, binaryInput, enableBinaryOutput, luauExecutionTaskView, luauexecutiontasklogs_query (maxPageSize, pageToken, view).
– Notification: operation createusernotification. Arguments: userId (destination user), universeId (source universe), notificationMessageId (Creator Dashboard notification-string asset ID), notificationParametersJson (optional JSON parameter values using stringValue or int64Value objects), notificationLaunchData (optional, maximum 200 bytes), and notificationAnalyticsCategory (optional analytics grouping category).
– Place: operations getplace, publishplace (Beta), updateplace. Arguments: universeId, placeId, placeVersionType (Published or Saved), binaryPropertyName (files ending in .rbxlx are sent as XML, anything else as binary .rbxl), placeupdate_mask (displayName, description, serverSize).
– Secret (Beta): operations listsecrets, getpublickey, createsecret, updatesecret, deletesecret. Arguments: universeId, secretId, secretContentMode (plaintext encrypts for you with the universe public key; encrypted sends content you already sealed), secretContent, secretKeyId (only for pre-encrypted content), secretDomain, secretlistquery (limit, cursor).
– Server Management (Beta): operations listgameservers, listgameserverlogs, getgameserverfilteroptions, listrestarts, forecastrestart, launchrestart. Arguments: universeId, placeId, placeVersionNumber, jobId, filterOptionsFilter, serverquery (filter, maxPageSize, orderBy, pageToken), restartoptions (bleedOffDurationMinutes, placesJson, attributesJson).
– Storage: operations include data store control (listdatastores, deletedatastore, undeletedatastore, snapshotdatastores), data store entries and scoped entries (list, get, create, update, delete, increment, list revisions), memory store queues (create, read, discard), memory store sorted maps (list, get, create, update, delete), memory store flush (flushmemorystore, getmemorystoreflushoperation), and ordered data store entries (list, get, create, update, delete, increment). Arguments: universeId, dataStoreId, scopeId, entryId, queueId, sortedMapId, itemId, orderedDataStoreId, operationId, dataStoreEntryJson, incrementDataStoreEntryJson, memoryStoreQueueItemJson, discardMemoryStoreQueueItemsJson, memoryStoreSortedMapItemJson, orderedDataStoreEntryJson, incrementOrderedDataStoreEntryJson, query/update collections for list, create, read, and update operations (filter, maxPageSize, pageToken, showDeleted, id, allowMissing, allOrNothing, count, invisibilityWindow, orderBy).
– Team Create: operations closeteamtestsession, getactivesessionmembers, getmanyteamcreatesettings, getteamcreatesettings, removeteamcreatemembership, updateteamcreatesettings. Arguments: placeId, gameId, teamcreate_pagination (cursor, limit), universeId, isEnabled, userId, universeIds.
– Universe: operations generatespeechasset, getplaceuserrestriction, getuniverse, getuserrestrictionuniverse, getuserrestrictionsuniverse, listplaceuserrestrictions, listuserrestrictionlogs, publishuniversemessage, restartuniverseservers, updateuniverse, updateplaceuserrestriction, updateuserrestrictionuniverse. Arguments: universeId, placeId, userRestrictionId, topic, message, userrestrictionsquery (maxPageSize, pageToken), argumentslistuserrestrictionlogs (filter, maxPageSize, pageToken), idempotencyKeyKey, idempotencyKeyFirstSent, universeUpdateMask (required comma-separated writable fields), universeUpdateJson (required JSON object containing only writable fields), userRestrictionUpdateMask, userrestrictiongamejoin_restriction (active, displayReason, duration, excludeAltAccounts, privateReason, startTime), speechText, speechStyleFields (pitch, speed, voiceId).
– User: operations generatethumbnail, getthumbnailoperation, getsubscription, getuser, listinventoryitems (Beta). Arguments: userId, operationId, universeId, subscriptionProductId, subscriptionId, view, argumentsthumbnailgeneration (size, format, shape), inventoryitems_query (filter, maxPageSize, pageToken).

• Roblox Legacy

– Legacy Place: operations getfavoritescount, getuniverseproducts. Arguments: universeId, universeIds.
– Legacy User: operations getusernamehistory, getusernamesfromuserids. Arguments: userId, argumentsusernamehistory (limit, cursor, sortOrder), argumentsusernamesfromuser_ids (userIds, excludeBannedUsers).

• Roblox Cloud Trigger

– Events: Group Audit Log Entry, Group Join Request. Arguments: eventType, groupId, audit-log filters actionType, userId, limit, and join-request page size maxPageSize.

Group API Scopes

The Group resource uses the existing Roblox Cloud API key credential. Group Forum category, post, and comment list operations require group-forum:read. Join request reads require group:read; accepting and declining join requests, updating group memberships, assigning roles, and unassigning roles require group:write. Listing or getting roles can use group:read to include non-guest role permissions. Audit log, description, settings, group policy, manageable groups, and pending groups operations require legacy-group:manage; notification preference updates require legacy-user:manage. Roblox’s current Groups reference does not list an additional API-key scope for Get Group or List Group Memberships. Cookie-only Group ban and unban endpoints are unsupported by this API-key node; it does not store or transmit a .ROBLOSECURITY cookie.

Configs API Scopes

The Config resource uses the existing Roblox Cloud API key credential. Published config, full config, draft, and revision reads require the universe:read scope. Draft changes, draft reset, publish, and revision restore require the universe:write scope.

Notification API Scopes

The Create User Notification operation uses the existing Roblox Cloud API key credential and requires the user.user-notification:write scope.

User Subscription API Scopes

The Get Subscription user operation requires either universe:write or universe.subscription-product.subscription:read.

Universe API Scopes

Update Universe uses the existing Roblox Cloud API key credential and requires the universe:write scope. Supply only writable fields in universeUpdateJson and list those fields in universeUpdateMask; after updating, re-read the universe to verify the mutation, as Roblox recommends.

Bans and Blocks API Scopes

The universe and place user restriction operations use the existing Roblox Cloud API key credential. Listing and getting user restrictions, and listing user restriction logs, require universe.user-restriction:read. Updating universe-level or place-level user restrictions requires universe.user-restriction:write. Roblox also documents Group ban and blocked-keyword endpoints on the Bans and Blocks page, but they require legacy cookie authentication and are unsupported by the RobloxCloudApi API-key credential.

Team Create API Scopes

The Team Create resource uses the existing Roblox Cloud API key credential and requires the legacy-team-collaboration:manage scope.

Storage API Scopes

The Storage resource uses the existing Roblox Cloud API key credential. Standard data store control operations use universe-datastores.control:list, universe-datastores.control:delete, and universe-datastores.control:snapshot. Standard entry operations use universe-datastores.objects:list, universe-datastores.objects:read, universe-datastores.objects:create, universe-datastores.objects:update, universe-datastores.objects:delete, and universe-datastores.versions:list. Memory store queues use memory-store.queue:add, memory-store.queue:dequeue, and memory-store.queue:discard; memory store sorted maps use memory-store.sorted-map:read and memory-store.sorted-map:write; memory store flush uses memory-store:flush. Ordered data store reads require universe.ordered-data-store.scope.entry:read; ordered data store writes require universe.ordered-data-store.scope.entry:write.

Luau Execution API Scopes

The Luau Execution resource uses the existing Roblox Cloud API key credential. Creating session tasks and binary inputs requires universe.place.luau-execution-session:write. Reading session tasks and logs requires universe.place.luau-execution-session:read; Roblox also allows those reads with universe.place.luau-execution-session:write.

Asset and Place Publishing API Scopes

Asset reads (get_asset, versions, operations, quotas) require asset:read. Creating, updating, rolling back, archiving, and restoring assets require asset:read and asset:write. Uploads come from an n8n binary field, up to 20 MB per file. Publish Place requires universe-places:write and is limited by Roblox to 30 requests per minute per API key owner.

Developer Product and Game Pass API Scopes

Developer product reads require developer-product:read and writes require developer-product:write. Game pass reads require game-pass:read and writes require game-pass:write. To attach an icon, put the image in an n8n binary field and enter its name in productImageBinaryProperty.

Server Management and Analytics API Scopes

Listing game servers, reading server logs, getting filter options, listing restarts, and forecasting restarts require universe:read. Launching a restart requires universe:write. Analytics queries and their operations require universe.analytics:read.

Secrets API Scopes

Listing secrets and getting the public key require universe.secret:read. Creating, updating, and deleting secrets require universe.secret:write. In plain-text mode the node fetches the universe public key and encrypts the content with a libsodium sealed box (using tweetnacl and blakejs) before sending it, so the plain value never leaves n8n unencrypted.

Inventory API Scopes

List Inventory Items requires user.inventory-item:read unless the user has made their inventory public.

Prerequisites

Before getting started, ensure you have the following:

• Git
• Node.js (v20 or higher recommended)
• n8n installed globally

  npm install -g n8n
  

Setup

1. Clone this repository:

   git clone https://github.com/LordMerc/roblox-n8n.git
   cd roblox-n8n
   

2. Install dependencies:

   npm install
   

3. Start developing or customizing your own nodes within the /nodes and /credentials directories.

4. Run linter checks:

   npm run lint       # Check for issues
   npm run lintfix    # Auto-fix common issues
   

Running Locally

To test your custom node within your local n8n environment, follow the official guide here:
👉 Run your node locally

Roblox Open Cloud API Docs

Learn more about the endpoints and features available from Roblox’s Open Cloud platform:
📚 Roblox Cloud Documentation

Contributing

If you improve or expand functionality, feel free to open a PR! This is a community project meant to accelerate Roblox ↔ automation use cases.

License

MIT License