Salesforce Developer Tools Workbench



You can obtain a session ID a few different ways, but the easiest—because you’re 
already in Workbench—is to grab the ID from there. In the top menu, select 
info -> Session Information and then expand the Connection folder to find the 
session ID.

Now open up terminal or the command prompt and enter your cURL command, which 
will be similar to the following:

  -H 'Authorization: Bearer <your_session_id>' 
  -H 'X-PrettyPrint:1'

// Running your own instance of Workbench on Heroku:

Workbench is a web application written in PHP, and it requires hosting. There 
is a publically available version hosted @ 
but hosting your own has some advantages that the public version does not, 
including use of the browser plugins. Luckily, there is a simple and free way to 
host your own through Heroku with minimal effort required.

1. Login to Heroku, or sign-up @

2. Navigate to and find the 
   “Deploy to Heroku” button under the getting started section, and click it.

3. You should now be on a Heroku page that says “Deploy your own Workbench.”  
   Name your application something convenient (optional) then click 
   “Deploy for Free”

4. Click on "Manage App"

5. Click on Settings

6. Click on "Reveal Config Vars"

7. Click on "Edit" next to  "forceworkbench__loginCsrfEnabled" and change it to

8. Click on "Open Application" in the top right corner

9. Make note of the URL of your application

10. Download and install the browser plugin.
     Chrome: (You will need to search for Workbench browser extension in the Chrome Webstore)

11. Next, you will need to point the extension at the URL of your Workbench 
    instance. In your browsers extension / add-on menu there should be an 
    “options” link for Workbench.
    Firefox: Tools -> Add-ons -> Extensions -> Workbench Tools for Firefox -> Preferences
    Chrome: Settings -> Extensions -> Workbench Tools for Google Chrome -> Options
    Alternatively, if you are logged into Salesforce, the extension icon should 
    appear and you can right click that to access the options.  Once there, fill 
    in the URL of workbench (but don’t include login.php).

To use the Workbench browser plugin:

1. Login to your org.

2. Navigate to a standard Salesforce page. The easiest way to do that is to 
   click the “Home” tab. Visualforce pages do not work for this extension (we 
   might teach you why later).

3. Locate the extension button. It will appear as a blue cube to the right of 
   the URL bar (in Firefox you may need to add the button to menu bar).

4. Click the extension button! You can jump to the SOQL Query section to test, 
   or try any of the other tools.  If you encountered the error “login method 
   not supported” there is an environment variable that needs to be changed.  
   Return to the section  “Installing Workbench” and follow the instructions to 
   modify the environment variable.

A lot of this information comes from:
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License