Connect your Slack account to Goodweek to send messages, read conversations, and manage channels directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Slack, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Slack integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Slack integration uses OAuth 2.0. In most workspaces, any member can connect directly. However, if your Slack workspace has app approval enabled, a Workspace Owner or App Manager must approve Composio first.
Scenario 1 — Default (no app approval required)
Any user can connect their Slack account directly. Follow the User Connection steps below.
Scenario 2 — App approval is enabled
If your workspace has "Require App Approval" enabled, a Workspace Owner or App Manager must approve Composio first:
In Slack, click your workspace name → Tools & settings → Manage apps → App management settings.
Search for Composio in the pending app requests, or add it manually, and approve it.
If Composio does not appear in the pending requests yet, a user must first attempt to connect from Goodweek — this generates an installation request the admin can then approve. Non-admin users will see their request stuck in "Request Submitted" until the admin acts.
Scenario 3 — Enterprise Grid workspaces
In Slack Enterprise Grid organizations, app management policies are set at the organization level by Org Owners. If your organization has an app approval policy, the Org Owner must approve Composio at the organization level:
Click your workspace name → Settings & administration → Organization settings.
Go to Settings → Organization Policies → Apps tab and approve the Composio app request.
⚠️ Enterprise Grid plan requirement for some tools
Certain admin-level Slack tools (workspace management, advanced conversation management) require an Enterprise Grid plan. If you are on a Free, Pro, or Business+ plan, these specific tools will not be available, but standard messaging and channel tools will work normally.
User Connection
In Goodweek, go to Integrations.
Find Slack and click Connect.
You will be redirected to Slack, where you will be asked to sign in and authorize access.
Select the workspace you want to connect and click Allow to return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access channels and conversations that your individual user account is a member of. Private channels you have not been invited to are not accessible.
If you belong to multiple Slack workspaces, you will need to connect each workspace separately.
You can revoke Goodweek's access at any time from your Slack workspace → Apps → Composio → Remove app.
Available Tools
Tool | Description | Type |
Send Message | Posts a message to a Slack channel, DM, or private group. | Write |
Send Ephemeral Message | Sends a message visible only to a specified user in a channel — other members cannot see it. | Write |
Schedule Message | Schedules a message to a Slack channel or DM for a future time. | Read |
Update a Slack Message | Updates an existing Slack message by its timestamp. | Read |
Reply to Thread | Posts a message as a reply within an existing thread. | Write |
Fetch Conversation History | Fetches a chronological list of messages and events from a specified Slack conversation. | Read |
Retrieve Conversation Replies | Retrieves replies to a specific parent message in a Slack conversation. | Read |
Search Messages | Searches messages across the workspace with date ranges and filters such as in:#channel or from:@user. | Read |
Real-Time Search | Searches Slack messages, files, channels, and users via the Real-Time Search API. | Read |
Get Unread Messages from User | Retrieves unread direct messages from a specific user. | Read |
List Unread Channel Messages | Lists all unread messages in a specified Slack channel for the authenticated user. | Read |
List All Channels | Lists conversations available to the user with various filters. | Read |
Retrieve Conversation Information | Retrieves metadata for a Slack conversation by ID (name, purpose, creation date, etc.). | Read |
Find Channels | Finds channels in a Slack workspace by name, topic, purpose, or description. | Read |
Get Conversation Members | Retrieves a paginated list of active member IDs for a specified channel. | Read |
Create Channel | Creates a new public or private Slack channel. | Write |
Invite Users to Channel | Invites users to an existing Slack channel using their Slack User IDs. | Write |
Add Reaction to Message | Adds an emoji reaction to an existing message in a Slack channel. | Write |
Remove Reaction from Item | Removes an emoji reaction from a message, file, or file comment. | ⚠️ Destructive |
Upload or Create a File in Slack | Uploads files, images, or documents to Slack channels or threads. | Write |
List Slack Files | Lists files and their metadata within a Slack workspace, filterable by user, channel, or type. | Read |
Download Slack File | Downloads Slack file content and converts it to a publicly accessible URL. | Read |
Create Slack Canvas | Creates a new Slack Canvas with a specified title and optional content. | Write |
Edit Slack Canvas | Edits a Slack Canvas with granular control over content placement (replace, insert, etc.). | Read |
Find Users | Finds users in a Slack workspace by email, name, display name, or other text. | Read |
Retrieve Detailed User Information | Retrieves comprehensive information for a valid Slack user ID. | Read |
Retrieve User Profile Information | Retrieves profile information for a specified Slack user. | Read |
List All Users | Retrieves a paginated list of all users with profile details and team memberships in a workspace. | Read |
Set User Presence | Manually sets a user's Slack presence (active/away). | Read |
Set DND Duration | Turns on Do Not Disturb mode for the current user or changes its duration. | Read |
Create a Reminder | Creates a Slack reminder with specified text and time using natural language or timestamps. | Write |
List Reminders | Lists all reminders for the authenticated Slack user. | Read |
Create Slack List | Creates a new Slack List with a name and optional description. | Write |
Create Slack List Item | Creates a new item (row) in a Slack List. | Write |
Update Slack List Item | Updates one or more cells in an existing Slack List row. | Write |
Delete a Public or Private Channel | Permanently deletes a channel including all its messages and files. This action is irreversible. | ⚠️ Destructive |
Remove User from Conversation | Removes a specified user from a Slack channel. | ⚠️ Destructive |
Delete a File by ID | Permanently deletes an existing file from a Slack workspace. This action is irreversible. | ⚠️ Destructive |
Use Cases
Send and manage messages from Goodweek. Post messages to channels, reply to threads, or send direct messages without switching to Slack — keeping communication in context with your work.
Search and retrieve messages and files. Find specific conversations, messages, or files across your Slack workspace from within a Goodweek conversation, without scrolling manually through channels.
Manage channel membership and structure. Create channels, invite users, and manage channel settings directly from Goodweek when setting up new projects or teams.
Create and update Slack Canvases and Lists. Draft structured Slack Canvases or manage List items from Goodweek to keep team knowledge and task tracking up to date.
Troubleshooting
My connection request is stuck in "Request Submitted"
Your Slack workspace has app approval enabled and a Workspace Owner or App Manager has not yet approved Composio. Contact your Slack admin and ask them to approve the Composio app.
Admin approved Composio but users still cannot connect
In Enterprise Grid organizations, workspace-level approval may not be sufficient. The Org Owner may need to approve Composio at the organization level following Scenario 3 above.
Connected successfully but certain tools are not working
Some advanced Slack tools require an Enterprise Grid plan. If you are on a lower plan, these tools will not function. Standard messaging and channel tools should work normally.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Slack integration from the Goodweek Admin Panel under the Integrations tab.