Skip to main content

Connect to Slack

You can connect to Slack and make it available as a resource in Retool. Once complete, your users can send interactive messages, update user groups, manage channels, and much more.

Requirements​

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

  • your Slack client ID (only required when you self-host Retool).
  • your Slack client secret (only required when you self-host Retool).
  • an administrator of your workspace to approve the request to authenticate and install the Retool app.

1. Create a new resource​

Sign in to your Retool organization and navigate to the Resources tab. Click Create new, then select Resource.

Create a new resource

2. Select the resource type​

Retool can connect to almost any API or database, and has built-in integrations for popular data sources. Select the Slack resource type.

Select the resource type

3. Configure the resource​

Specify a name and location for the Slack resource. Retool displays the resource name and type in query editors to help users identify them.

By default, Retool requests a limited set of common OAuth scopes when you connect your workspace. These scopes determine the operations you can perform. If you update the list of scopes in your resource settings, you have to reconnect with OAuth for the changes to take effect.

Configure the resource

If you self-host Retool, complete the Self-hosted deployments section before moving to the next step. Otherwise, click the Connect with OAuth → button to authenticate with your Slack workspace and continue to the next step.

Self-hosted deployments​

caution

This section is only necessary if you self-host Retool.

When you self-host Retool, you need to register your own application with Slack. After registering, you can find your client ID and client secret on your Slack app settings page. Your client ID and client secret need to be copied into your resource settings.

Configure the resource

You also need to configure your Slack app with the OAuth callback URL and scopes. Copy the OAuth callback URL on the Retool resource settings page. Then, in your Slack app settings, click OAuth & Permissions in the left sidebar, and add the OAuth callback URL to the Redirect URLs section.

You also need to add every scope that your Retool resource requests to the Bot Token Scopes section in your Slack app settings.

After you've finished setting up your Slack app and resource, click the Connect with OAuth → button on the resource settings page to authenticate.

4. Save the resource​

Click Create resource to complete the setup. You can then click either Create app to immediately start building a Retool app or Back to resources to return to the list of resources.

Wrap up​

Your Slack resource is now ready to use. To interact with Slack, select the resource in the query editor. See Slack's API documentation for a full list of API methods.