Table of Contents
A Sandbox is an isolated space where you can test, experiment, or learn without impacting the data in your production environment.
Sandboxes allow you to safely test workflows, integrations, and automations, train new users in a realistic environment, and experiment with configurations before promoting them to production.
Availability & Sandbox Types
Sandboxes are available on Professional and Premium plans, and will be created with sample data by default.
- Professional Plan: Includes access to 1 sample data sandbox.
- Premium Plan: Includes access to 2 sample data sandboxes.
Production Copy Add-on
Users have the ability to purchase an add-on that allows you to create a Production Copy sandbox. The production copy will allow you to restore a weekly backup of your production account to your sandbox so you can have a replica of your current account on your sandbox environment. For more info, or to purchase the addon, please reach out to your customer success manager.
How to Get Started
- Navigate to Settings and select Sandboxes in your Fleetio account.
- Select + Add Sandbox.
- Enter the name of your sandbox. This will determine the URL used to access the sandbox after creation ex.
https://sandboxname.sandbox.fleetio.com/
- Select Save to begin creating your Sandbox. Provisioning is not instant and can take anywhere from 15 minutes to a few hours, depending on the size of your account.
- Once ready, you will access it via the name you selected above, followed by .sandbox.fleetio.com. Ex:
https://sandboxname.sandbox.fleetio.com/- Log in with your existing Fleetio credentials.
One the new sandbox account is created, you will need to recreate any necessary API keys, OAuth tokens, SAML/SSO, or Webhooks.
Data Refresh & Sync
You will have the ability refresh your sandbox on demand to undo any changes you have made to sample data, or to bring your production copy to a more current snapshot of your production environment.
Refreshing your sandbox will:
- Delete and reset all current workflows.
- Remove any API keys, OAuth Tokens, SAML/SSO, or webhooks.
- Remove any automations set up in the sandbox that were not mirrored into production.
- Restore data from the most recent Monday production snapshot.
Before refreshing, export or save anything you want to keep. All current sandbox changes will be lost.
What's Limited or Disabled
Since the sandbox is an isolated environment, certain features are restricted:
- Integrations: Native integrations (e.g., telematics, fuel cards) are not supported at this time. Third-party integrations will not be copied from production and must be configured manually using sandbox URLs.
-
API & Auth: No API keys, OAuth tokens, webhooks, or SAML/SSO are copied from production. You must create new ones in the sandbox and use your sandbox domain to make API calls (e.g.,
https://sandboxname.fleetio.com/api/vehicles). - Data: For Production Copy sandboxes, the following data is not cloned: Location entries, GPS trips, VIN decode results, and unassigned fuel card transactions.
- Billing: Billing is fully disabled. No changes in the sandbox affect your production subscription.
- Shop Network: The Maintenance Shop Network (Auto-Integrate) is also not supported.
- Documents: You can safely view and manage documents without impacting production.
