The B2C ODS tool window, at the bottom of the IDE, manages the on-demand sandboxes of your realms through the Salesforce ODS API. It uses an API client, not a project connection
Add a configuration
A configuration is one API client on one API server. Each configuration gets its own tab
Prepare the API client
In Account Manager, give your API client access to the sandbox API for your realm. Then add it on the API Clients tab of B2C Credentials
Create the tab
Open B2C ODS (View › Tool Windows, or More › Tool Windows). With no configuration yet it shows "No On-Demand Sandboxes Configurations". Click + (Add On-Demand Sandboxes Configuration)
Fill in the dialog
Enter a Name, pick the Api Server and select the OCAPI Credentials, then click Get Token and Save. The tab opens with the realm's sandboxes
The Api Server list has four hosts:
https://admin.dx.commercecloud.salesforce.com(default)https://admin.us01.dx.commercecloud.salesforce.comhttps://admin.us02.dx.commercecloud.salesforce.comhttps://admin.us03.dx.commercecloud.salesforce.com
Double-click a tab to rename it. Closing a tab removes the configuration after a confirmation. Edit Configuration in the toolbar opens the same dialog, with the credentials locked
Sandboxes table
| Column | Shows |
|---|---|
| [Name] Hostname | The sandbox hostname, with your custom name in brackets |
| State | For example started, stopped, starting or stopping |
| Realm | The realm ID |
| Resource Profile | Medium, Large or XLarge |
| Created By | Who created the sandbox |
The toolbar shows Total, Started and Stopped counters, plus Selected while rows are selected. States are coloured: started green, stopped red, starting cyan, new and creating orange
Refresh Sandboxes reloads the whole table under a progress stripe. With auto refresh on, the table checks every 10 seconds and replaces only the rows whose state changed. Type while the table has focus to jump to the first matching sandbox
Start, stop and restart
Select rows and use Start Sandbox, Stop Sandbox or Restart Sandbox in the toolbar (for example "Start 3 Sandboxes" with several selected). Start runs right away. Stop, Restart, Reset and Delete ask first and list the hosts they touch
Each button is enabled only when a selected sandbox can take the action: Start needs one that is not started, Stop and Restart need one that is not stopped. Hold Cmd (Ctrl on Windows and Linux) to select several rows
Sandbox menu
Right-click a sandbox
| Item | What it does |
|---|---|
| Edit Custom Name | Sets a display name. Leave it empty to remove it |
| Start, Stop, Restart | Same as the toolbar |
| Copy › ID, URL, Business Manager URL, Sandbox Data as JSON | Copies the value |
| Open Links › Business Manager, OCAPI, WebDAV, IMPEX, Logs | Opens the link in the browser |
| Reset Sandbox, Delete Sandbox | Resets or deletes the sandbox after a confirmation |
To work with a sandbox in the project, copy its URL and add it as a connection in Connections
Create a sandbox
Click Add Sandbox in the toolbar to open Create On-Demand Sandbox
| Field | Default | Notes |
|---|---|---|
| Realm | Loaded from the API ("Getting realms list...") | |
| Resource Profile | Medium | Medium, Large or XLarge. Larger profiles use more credits |
| Time to live (TTL) | 0 | Hours the sandbox lives, within your realm's quotas. 0 means it never expires |
Click Create On-Demand Sandbox. The plugin confirms "The sandbox creation has started!" with the new hostname, then reloads the table. Leave auto refresh on to follow the sandbox from new to started
With an AI agent
An agent connected to B2C MCP can list your sandboxes, check a realm's limits and plan starting, stopping, adding hours or creating one. Each change runs as a plan with the tools you gave the agent, and a new sandbox always gets a time to live, see What Agents Can Do
Troubleshooting
| Message | What to do |
|---|---|
| "Failed to get Access Token!" | The client ID, secret or API server is wrong, or the client has no sandbox API access for the realm |
| Client Secret is Empty | Edit the API client in B2C Credentials and add its secret |
| A configuration for these credentials already exists | Each API client can back one configuration. Use the existing tab |
| "Error occurred while getting realms" | The client can't list realms. Check its realm access in Account Manager |
| Sandbox is down during upload | The sandbox of the active connection is stopped. Start it here, then upload again |