Using Your Salesforce Sandbox

One of the very first steps to getting setup with Qualified is to connect to your Salesforce environment. This is not only going to allow for you to map over your visitor fields to create new Leads and Prospects, but it will also allow for you to pull information as well from Salesforce to personalize your visitor's experiences. 

What is a Sandbox?

If you have a Salesforce account, most likely you also have a test environment, or a Sandbox. Sandboxes are mainly used to create multiple copies of your Production environment, so that you have an exact replica of your Production environment without affecting your live data during your test period. If you don’t already have a Sandbox, you can easily create one by following the steps outlined in the Salesforce help documentation. You can also view what types of Sandboxes are available on the Salesforce help site.

Connecting to Your Sandbox in Qualified

Once you have your Sandbox created and ready for testing, you can connect it to to begin your setup and testing.

1) Navigate to Your Salesforce Connection Page

The first step you’ll want to take is heading over to your cog icon in your account and selecting Salesforce > Connection from your navigation.

2) Connect to the Sandbox

Next, use the option “Connect to Sandbox” underneath the main connection button. You’ll want to enter in your Sandbox credentials here after the pop up appears.

Option to connect to your Sandbox

You’ll also notice on this page that there are two places where you’ll need to connect to your Sandbox: Connecting with a Personal account and Connecting with a Team level account. 

The first is a personal user account for each sales rep using the system. The personal user accounts are used by each rep when creating Salesforce objects such as Leads, Contacts, Accounts, and Opportunities. Each user in your org will need to connect using their own personal Salesforce credentials. Most likely for your testing, you won’t need to connect all reps at this time and can wait until you’re using your Salesforce Production environment.

The second connection is a team-level account and it’s used by the system to read and write data as necessary. This is the main connection that we’ll use and this user will need access to read and write to all objects in your Sandbox. You can create a user specifically for the integration or use an existing integration user that has full rights.

Helpful Hint: To learn more on how these two connections work together visit our documentation on connecting to Salesforce Production as this information is the same.

Limitations of Sandbox Connections

You’ll want to be aware that there are some limitations to using the Sandbox for testing and connecting to Qualified. 

  1. When using a Sandbox connection you cannot have campaign attribution, Meaning, you won't be able to create campaign members from lead or contact records
  2. If you create fields and map them in and your Sandbox but these fields do not exist in your Production environment your mappings will most likely fail. Check to make sure that all fields are in Sandbox AND Production before going live.

Moving to Production

When you’re done with your testing in the Sandbox environment, you’ll now want to move to Production before you go live with Qualified. You’ll see the option to “Promote to Production” in your Salesforce connection area. 

Promote button shown on Salesforce connection page

When you press this button, we’ll keep your mappings in place but replace your credentials with your Production credentials so that it’s a smooth transition. 

Helpful Hint: You’ll want to make sure all of the fields that you’ve created within Qualified and tested in your Sandbox also exist in your production org. If they do not, your mappings will fail.


A Salesforce Sandbox is a test environment that allows for you to test integrations without disrupting your live production data. You can connect to your Sandbox environment in, but there are a few limitations such as the ability to add campaign attribution. Once you are done testing, you can easily use the ‘promote’ button to switch to your Production environment without disrupting the mappings you’ve created into Salesforce.

Request a live demo

See Qualified in action on your website. Request a live demo and one of our reps will contact you immediately, or talk to us right now.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Free custom demo
Live on your site