Skip to main content

Connect to Lambda

You can connect to Lambda and make it available as a resource. Once complete, you can write queries to interact with your Lambda functions.


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 Lambda resource, you need:

  • A Lambda IAM user with Programmatic access.
  • A Lambda permission policy attached to the IAM user that includes:
  • An AWS access key ID.
  • An AWS secret key ID.

See the AWS documentation for creating IAM users, creating IAM policies, and AWS security credentials for details on creating and obtaining these requirements.

If Lambda 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 Lambda resource

Retool can connect to almost any API or database, and has built-in integrations for popular data sources. Sign in to your Retool organization and create a new Lambda resource from the Resources tab.

2. Configure the resource

Provide the necessary details to configure the resource so Retool can connect to Lambda. 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., Lambda).


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 Lambda.

AWS region

The region of the service to connect to.

AWS Access Key ID

The AWS access key used to authenticate requests.

AWS Secret Key ID

The AWS secret key used to authenticate requests.

Role to assume (ARN)

An optional role to assume when making requests.

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.

Wrap up

Your Lambda resource is now ready to use. You write queries to make requests by specifying the function name and payload.

To verify you can successfully interact with Lambda, write a test query and select a test function from your Lambda instance in the Function name field, and enter an optional payload.