Developing automations requires a paid plan. Don't have one? Join the Developer Program and provision a sandbox with access to all Slack features for free.
Troubleshooting errors can be tricky between your development environment, the Slack CLI, and those encountered when running your code. Below are some common ones, as well as a list of the errors the Slack CLI may raise, what they mean, and some ways to remediate them.
If you are using VSCode with the Deno plugin and you run into an error where Deno isn't being honored properly by VSCode, this is because by default, VSCode treats the folder that's opened as the workspace root. If you open a parent folder, the .vscode/settings.json file must be moved to the root of THAT folder. This is because VSCode requires that deno.enable: true is set in that .vscode/settings.json file, and VSCode only honors this setting if it's in the root of the project.
Other common errors you may run into are static errors when the opening a parent directory that contains one or many apps inside. These include:
These errors occur because of that first one we covered — by default, VSCode treats the folder that’s opened as the workspace root; however, the .vscode/settings.json file and deno.jsonc file rely on being in the workspace root. To resolve this, open the app folder directly, or set up your own workspace config in VSCode.
You don't have the permission to access the specified resource
Check with your Slack Workspace Admin to make sure that you have permission to access the resource.
Couldn't save your app's info to this project
You're already logged out
The app already has a resolution and cannot be requested
Couldn't get a list of your apps
Couldn't create a new app
This app is currently denied for installation
Reach out to one of your App Managers for additional information, or you can try requesting again with different scopes and outgoing domains.
This app requires permissions that must be reviewed by an App Manager before you can install it
This app is currently waiting for App Manager approval
Reach out to one of your App Managers for additional information.
Couldn't create your app
Couldn't delete your app
Couldn't deploy your app
Deployment to Slack is currently supported for apps written with the Deno Slack SDK.
Couldn't access app directory
The app does was neither in the app directory nor created on this team/org, and cannot be requested
The --app flag must be provided
Choose a specific app with --app <app_id>
Couldn't install your app to a workspace
Couldn't access your app manifest
Couldn't create your app manifest
Couldn't generate an app manifest from this project
Check to make sure you are in a valid Slack project directory and that your project has no compilation errors.
Your app manifest is invalid
The specified app is not eligible for this API
The provided app must be installed on this team
The app was not found
The app is not configured to be deployed to the Slack platform
To configure an app to be deployed to the Slack platform, you can set the app manifest property "settings.function_runtime" = "slack".
Couldn't remove your app
Couldn't rename your app
Couldn't find a valid auth token for the Slack API
You need to be logged in to at least one production (slack.com) workspace to use this command. Log in to one with the slack login command and try again.
Couldn't receive authorization in the time allowed
Ensure you have pasted the command in a Slack workspace and accepted the permissions.
Couldn't get a token with an active session
The last owner cannot be removed
Unable to add the given user as owner
Unable to retrieve current app collaborators
Couldn't verify your authorization
Your app must be invited to the channel
Try to find the channel declared the source code of a workflow or function.
Open Slack, join the channel, invite your app, and try the command again. Learn more.
Unable to delete app
Calling user is unable to list collaborators
Calling user is unable to list owners
User is unable to remove collaborators
Unable to remove the given user
Revoking org-level bot token is not supported
Couldn't find the specified Slack channel
Try adding your app as a member to the channel.
Couldn't auto-update this command-line tool
You can manually install the latest version from here.
.slack/cli.json is not supported by this version of the CLI
You're using a version of the CLI that is not compatible with your project. This version of the CLI requires a slack.json file in the root directory of the project. Create a new project with this version of the CLI using slack create and migrate your code.
There was an error reading configuration
Check your config.json file.
Configuration invalid
Check your config.json file.
Slack API requires the latest version of the Slack CLI
You can upgrade to the latest version of the Slack CLI using the command: slack upgrade.
The Workspace Admin does not allow connected organizations to be named_entities
Your App Manager is requesting a reason to approve installation of this app
The Workspace Admin does not allow connected teams to be named_entities
No authentication found for this team
Use the command slack login to login to this workspace
Customizable input on the trigger must map to a workflow input of the same name
Customizable trigger inputs must map to required workflow inputs
Customizable inputs are only allowed on link triggers
Customizable input has been mapped to a workflow input of an unsupported type. Only UserID, ChannelId, and String are supported for customizable inputs
Couldn't access the default app
Couldn't set this app as the default
Couldn't find the 'deno' language runtime installed on this system
To install Deno, visit https://deno.land/#installation.
The installed version of Deno is unsupported
A deployed app cannot be used by this command
No environment variables associated with this workspace
The enterprise was not found
Failed writing a collaborator record for this new app
Failed to create the app model
Couldn't export the app manifest
At least one request was not canceled
Couldn't find the user to install the app
Couldn't save the logs
Failed to get teams for restricted user
Not an acceptable S3 file
The authenticated team cannot use this API
Free workspaces do not support the Slack platform's low-code automation for workflows and functions.
You can install this app if you upgrade your workspace to a paid plan.
The provided function_id does not belong to this app_id
The specified function couldn't be found
Couldn't find Git installed on this system
To install Git, visit https://github.com/git-guides/install-git.
Git failed to clone repository
Cannot download Git repository as a .zip archive
Failed to read/create .slack/ directory in your home directory
A Slack directory is required for retrieving/storing auth credentials and config data. Check permissions on your system.
Hosted apps do not support user scopes
HTTP request failed
Received an invalid response from the server
The method was not called via a POST request
Couldn't install the app because the installation request was denied
Reach out to one of your App Managers for additional information.
Couldn't install the app
A valid installation of this app is required to take this action
Install the app to a workspace with slack install.
An internal error has occurred with the Slack platform
Please reach out to feedback@slack.com if the problem persists.
Either the app does not exist or an app created from the provided manifest would not be valid
This is an invalid Slack app directory
A valid Slack app directory requires a Slack Configuration file (slack.json).
The provided --app flag value is not valid
Specify the environment with --app local or --app deployed
Or choose a specific app with --app <app_id>
App ID is invalid for this user account and workspace
Check to make sure you are signed into the correct workspace for this app.
Required arguments either were not provided or contain invalid values
A trigger input parameter with customizable: true cannot be set as hidden or locked, nor have a value provided at trigger creation time
Slack API request parameters are invalid
Your user account authorization isn't valid
Your user account authorization may be expired or does not have permission to access the resource. Try to login to the same user account again using slack login.
The challenge code is invalid
The previous slash command and challenge code have now expired. To retry, use slack login, paste the slash command in any Slack channel, and enter the challenge code displayed by Slack. It is easiest to copy & paste the challenge code.
Channel ID specified doesn't exist or you do not have permissions to access it
Channel ID appears to be formatted correctly. Check if this channel exists on the current workspace and you have permissions to access it.
Value passed for cursor was not valid or is valid no longer
This function requires permission_type to be set as named_entities before adding users
One or more input parameter types isn't supported by the link trigger type
Interactivity at current step needs to be mapped to an interactivity in the step directly previous to the current step's output. This error is thrown to ensure a function is not allowed to use an interactivity input to open a view that is not directly tied to some interaction that the user takes.
The provided manifest file does not validate against schema. Consult the additional errors field to locate specific issues
slack_cli_version supplied is invalid
This trigger requires permission_type to be set as named_entities before adding users
The given refresh token is invalid.
The request_id passed is invalid
The resource_id for the given resource_type is invalid
The resource_type argument is invalid.
An internal error occurred with the Slack platform
Please reach out to feedback@slack.com if the problem persists.
Some of the provided scopes do not exist
Current directory is not a Slack project
Change in to a Slack project directory. A Slack project always includes the Slack Configuration file (slack.json).
Invalid datastore specified in your project
The provided expression is not valid
Verify the expression you provided is valid JSON surrounded by quotations.
The provided token is not valid
Invalid trigger specified in your project
Trigger access can not be configured for more than 10 users
The provided trigger object does not conform to the trigger type's schema
The provided event type is not allowed
Required inputs for the referenced function/workflow are not passed
The provided trigger type is not recognized
A value passed as a user_id is invalid
Only one of schema or schema_ref should be provided
Unable to parse the schema ref
A value passed as workflow_app_id is invalid or missing
A value passed as a workflow ID is invalid
Restricted users cannot request
Couldn't find the local app
A local app cannot be used by this command
Couldn't remove local app
Couldn't run app locally
This API method is not supported
workflow_app_id is required to update via workflow reference
Challenge must be supplied
Could not find the given workflow using the specified reference
Your login is out of date
Run slack logout and then slack login again.
Additional scopes are required to create this type of trigger
The user was not found
Missing value property on an input. You must either provide the value now or mark this input as customizable: true and provide the value at the time the trigger is executed.
You are either not logged in or your login session has expired
Incompatible token type provided
Coudn't find row
Couldn't upload your bundled code to server
Please try again.
Pending request not found
You're not a collaborator on this app or you do not have permissions to perform this action
Contact the app owner to add you as a collaborator.
No tokens found to delete
None of the provided named entities were valid
This operating system is not supported
Workspace exceeded the maximum number of functions and/or app datastores
There were problems when validating the inputs against the function parameters. See API response for more details
An error occurred while compiling your code
Failed to update project files
The provided provider_key is invalid
An error occurred while executing prompts
This action is only permitted for published app IDs
Must include a request_id or app_id
Too many calls in succession to create endpoint during a short period of time
The SDK language's executable (deno, node, python, etc) was not found to be installed on the system
Couldn't create app from sample
Your workspace has exhausted the 10 apps limit for free teams. To create more apps, upgrade your Slack plan.
The Workspace Admin does not allow shared channels to be named_entities
There was an error while reading the Slack Configuration file (slack.json) or running the get-hooks hook
Run slack doctor to check that your system dependencies are up-to-date.
A script hook defined in the Slack Configuration file (slack.json) returned an error
Run slack doctor to check that your system dependencies are up-to-date.
A script in slack.json was not found
Every app requires a slack.json file. Most apps do not need to modify the file; you can find a working example here. Ensure that deno-slack-hooks is installed at the project level and that the version is not less than v1.3.0.
The get-trigger script/hook in slack.json was not found
Try defining your trigger by specifying a .json file instead.
You are not logged in to a workspace or have not installed an app
Use the command slack login to login and slack install to install your app.
Missing a Slack Configuration file (slack.json) in the project's root directory
You're using a version of the CLI that is not compatible with your project. This version of the CLI requires a slack.json file in the root directory of the project. Create a new project with this version of the CLI using slack create and migrate your code.
Couldn't connect to Slack over WebSocket
Scopes requested exceed app configuration
Couldn't verify all system requirements
An error occurred while accessing your datastore
Team access not granted (generated)
One or more of the listed teams was not connected by org
One or more of the listed teams could not be found
Cannot query team by domain because team is not on an enterprise
Total number of requests exceeded team quota
One or more of the listed organizations was not connected
One or more of the listed organizations could not be found
Your access token has expired
Use the command slack login to authenticate again.
Your token has already been revoked
Use the command slack login to authenticate again.
An error occurred while rotating your access token
Use the command slack login to authenticate again.
Cannot have more than 10 customizable inputs
Ensure you provide only app_id OR request_id
Too many named entities passed into the trigger permissions setting
Couldn't create a trigger
Couldn't delete a trigger
The trigger provided does not exist
The specified trigger cannot be found
Couldn't update a trigger
There was an error deleting tokens
Error with file upload
<json> Couldn't be parsed as a json object
The uninstall process was interrupted
Unknown file type, must be application/zip
The provided function_id was not found
The Slack API method does not exist or you do not have permissions to access it
Unable to find the corresponding type based on the schema ref
The provided workflow_id was not found for this app
Must include a user_id to cancel request for an app with app_id
File name is not supported
The user is already an owner for this app
The user has a request pending for this app
You do not have permissions to install this app
Reach out to one of your App Managers to request permissions to install apps.
User cannot be found
User removed from team
Workflow not found
The --workspace flag must be provided
Choose a specific workspace with --workspace <team_domain> or --workspace <team_id>
Couldn't get a list of workspaces
An error occurred while parsing the app manifest YAML file
Have 2 minutes to provide some feedback?
We'd love to hear about your experience building Slack automations. Please complete our short survey so we can use your feedback to improve.