Developer Sandbox
Access your very own Webex Sandbox for building and testing new bots, integrations, and embedded apps.
anchorIntroduction
anchorA Developer Sandbox provides you with administrator access to a licensed Webex organization you manage using Webex Control Hub . A licensed org lets you create and test capabilities of the Webex platform not available with Webex free plans (see Do I need a Developer Sandbox? for details).
anchorSandbox Quick Start
anchorIf you are signed in to the Developer Portal when you request a sandbox, the credentials for your new account are sent to the email associated with your Webex account; if you are not signed in you will be prompted to provide an email.
To request a Sandbox Organization:
Click Request a Sandbox at the top of this page.
If you want your sandbox to be configured with the all the features of the new Webex Suite Meeting Platform, please contact support requesting that configuration. This is particularly important if you want to test and execute the space meeting migration flows. The standard sandboxes are configured with the legacy meetings platform. Please also refer to this document for differences.
Click Accept in the dialog box that appears. Enter your email address, if prompted, then click Submit.
If the Submit button doesn't work try signing out of your Webex account and then trying again, providing your email address when prompted.
Check your email for the account credentials for your admin account. The email will be titled "Collab Toolbox Provisioning Notification".
anchorSign in to Your Account
anchorThe provisioning email you receive contains the following information for your sandbox organization:
- Organization name: (e.g. jdoessandboxtest-1xep)
- Username/email: (e.g. admin@jdoessandboxtest-1xep.wbx.ai)
- Password
- Webex Site URL: (e.g. jdoesandboxtest-1xep.webex.com)
To avoid any potential conflicts with your primary Webex account it's recommended that you use a private or incognito browser window to perform the sign in.
To sign in to Control Hub for your org:
Open a new browser window, or open a private/incognito window (Ctrl+Shift+N or Cmd+Shift+N on Chrome for Windows or MacOS, or Ctrl+Shift+P or Cmd+Shift+P on Firefox for Windows or MacOS).
We recommend using the latest desktop version of Google Chrome or Mozilla Firefox. Other browsers may produce unexpected results. Webex Control Hub is not designed for mobile devices.
In the new/private browser window open Webex Control Hub. You may need to copy and paste the URL (
https://admin.webex.com
) into your browser if the link doesn't open in the new/private window.In the sign in form enter the username/email address from the provisioning email.
Enter the password from the provisioning email.
Click Accept to agree to the terms of service.
And that's it! You now have your very own Sandbox for testing your Webex apps. See Next Steps and Learn More to learn what you can do.
anchorNext Steps and Learn More
anchorThis section contains details about how to use your Developer Sandbox.
Using Webex Control Hub — Webex Control Hub is how you manage and monitor all aspects of your Webex organization. See Get Started with Webex Control Hub for an introduction to what you can do with Control Hub.
Adding Users to your Organization — You'll likely want to invite users to join your sandbox organization. The easiest way is to manualy add users. You can also assign roles to your users.
Users invited to join your sandbox organization must not use an email associated with an existing Webex account. Admins should use alternate email addresses to invite users with existing Webex accounts.
Making Admin API calls — To use the Admin or Compliance APIs you'll need to generate authentication tokens using your sandbox administrator account, or other admin user you've added to your organization. Similarly, to use the Try It feature in the interactive API reference as an admin, you will need to sign in to the Developer Portal with your sandbox's administrator account credentials.
Create and Manage Embedded Apps — Any user in your sandbox organization can create an embedded app via the Developer Portal. Users must sign in using their sandbox org credentials, not with their main Webex account.
To make embedded apps available to other users in your sandbox organization, the app must be submitted for approval by the user who created the app, and approved by an organization admin. See the following links for more information.
- Creating an Embedded App in the Developer Portal
- Submitting an Embedded App for Approval
- See Managing Embedded Apps to learn how to approve embedded apps.
Other resources:
anchorDo I need a Developer Sandbox?
anchorA Developer Sandbox provides you with admin access to a licensed Webex organization. A licensed org is required if you need to test features of the Webex platform not available to Webex free plans. Specifically, access to a licensed organization is required to perform the following development and testing tasks:
- Create and test Webex Embedded Apps.
- Create integrations that require admin and compliance API testing.
- Test Webex Messaging bots and integrations in locked (moderated) spaces.
If you aren't developing these types of apps or features you don't necessarily need a Developer Sandbox to develop and test your code.
Each Webex Developer Sandbox use is limited to a maximum of 10 account users for validation and test purposes only. Cisco may from time to time audit Webex Developer Sandbox accounts and reserves the right to remove users in excess of 10 account users, or terminate the Webex Developer Sandbox environment for any Developer resource misuse.
anchorAsk the Experts
anchor- If you're having trouble accessing your new Sandbox, please reach out to Devsupport@webex.com or go to Developer Support
anchorTerms and Conditions
anchorPlease see Terms of Service for the Webex developer terms and conditions.