You can connect Retool to a wide range of APIs using our native integrations. You can also connect to any REST API and make it available as a resource. Once complete, you can write queries to interact with the API.
All users for Retool organizations on Free or Team plans have global Edit permissions and can add, edit, and remove resources. If your organization manages user permissions for resources, you must be a member of a group with Edit all permissions.
To create your REST API resource, you need:
- the base URL for the API.
If your REST API is behind a firewall, you must also allow access from Retool's IP addresses. Add these IP addresses to your firewall's allowlist before you create the resource.
1. Create a new resource
Sign in to your Retool organization and navigate to the Resources tab. Click Create new, then select Resource.
Retool can connect to almost any API or database, and has built-in integrations for popular data sources. Select the REST API integration.
2. Configure the resource
Provide the necessary details to configure the resource so Retool can connect to your REST API. Not all settings are required.
These settings configure the name and location of the resource within Retool.
The name to use for the resource (e.g., REST API).
The folder in which to save the resource.
A brief description of the resource (e.g., Customer data).
These settings configure how Retool connects to your REST API.
The base URL for the REST API. This must be an absolute URL.
Key-value pairs to include as URL parameters with REST API requests. You can optionally include current_user and retoolContext properties to dynamically include details about the current user or the current app.
Key-value pairs to include as headers with REST API requests. You can optionally include current_user and retoolContext properties to dynamically include details about the current user or the current app.
Key-value pairs to include in the body of REST API requests.
Cookies to include with REST API requests.
The method of authentication to use with REST API requests.
Forward all cookies
Whether to forward all cookies. This is useful if you have dynamic cookie names.
3. Save the resource
Click Create resource to complete the setup. You can then click either Create an app to immediately start building a Retool app or Back to resources to return to the list of resources.
Your REST API resource is now ready to use. You write queries to make API requests by specifying the request method and endpoint, additional parameters to include, and the request body.
To verify you can successfully interact with your REST API, write a test query to retrieve some data. The following example retrieves a list of customers from a sample API.
"name": "Renata Nind",
"name": "Sibylle Anten",
"name": "Johannah Lauks",
"name": "Stuart Cullrford",
"name": "Ulick Linne",