Documentation

Welcome to Retool! We're a fast way to build custom internal software.

You'll find the 5 minute demo, quickstart guide, and documentation for each of our connectors and components here. If you've got any questions -- chat with us on the bottom right!

Get Started    Guides

Salesforce Integration

Query Salesforce via Retool.

You can query Salesforce via Retool easily. Before doing so, though, you have to setup Salesforce first. To do that, you'll need to create the app in Salesforce, and then

Setting up a Salesforce resource

To setup Salesforce, you'll need to

Create an app in Salesforce

First, you have to register Retool as a "Connected Application" under Salesforce.

  1. Create a new connected app:
    • In Lightning Experience, use the App Manager to create connected apps. type App Manager in the quick search box. Then, click New Connected App.
    • In Salesforce Classic, from Setup, enter Apps in the Quick Find box, then select Apps (under Build -> Create). Under Connected Apps, click New.
  2. Enter the name + contact info. Try Retool, and your own email!
  3. Tick Enable OAuth Settings, and enter the callback URL that Retool gives you from the resource screen:
The OAuth Callback URL to use with Salesforce.

The OAuth Callback URL to use with Salesforce.

  1. Add all supported OAuth scopes to Selected OAuth Scopes. These scopes refer to permissions given by the user running the connected app. If you add Full access we also need access and manage your data and perform requests on your behalf (a bit confusing - full access does not actually grant everything).
An example of how to configure Salesforce for use with cloud hosted Retool

An example of how to configure Salesforce for use with cloud hosted Retool

  1. Click Save. The Consumer Key (aka. the client id) and Secret (aka. the client secret) are created.

Add the app to Retool

  1. Create a new resource, and select Salesforce.
  2. Add the key + secret + instance URL (your Salesforce URL), and then press "Test Connection" to ensure the connection works.
  3. Hit save!

Querying the Salesforce API

After setting up a Salesforce integration with Retool, a new option for a Salesforce query will appear on the Retool page editors. After selecting that option, you will be presented with a UI that allows you to use the Salesforce Object Query Language (SOQL) to retrieve data from Salesforce.

Bulk Operations in Salesforce

Retool supports Bulk Inserts, Bulk Updates, Bulk Upserts, and Bulk Delete from Salesforce. Here are examples of these!

Bulk Inserts

Bulk Update

Salesforce Integration


Query Salesforce via Retool.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.