Slack Integration
Receive OKR notifications, submit check-ins, and view progress summaries directly in Slack
The Slack integration connects OKR Studio to your Slack workspace via OAuth 2.0. Your team can submit OKR check-ins, receive automated notifications, and view progress summaries without leaving Slack.
Slash Commands
- •
/okr checkin— Submit a Key Result check-in - •
/okr summary— View current cycle progress - •
/okr status— View your personal KR progress dashboard - •
/okr list— View all active OKRs for the current cycle - •
/okr help— List available commands
Automated Notifications
- • Weekly progress summaries (Monday 9 AM)
- • At-risk Key Result alerts (daily)
- • Check-in reminders via DM (daily)
- • KR update confirmations
Before You Begin
- • You need Admin access in your OKR Studio organization
- • Your OKR Studio plan must include integrations (Professional or Enterprise)
- • You need admin access to your Slack workspace to approve the app installation
- • Team members' Slack email addresses must match their OKR Studio accounts
- 1
Navigate to Integrations
Go to Settings → Integrations in your OKR Studio workspace
- 2
Click the Slack tab
Select the Slack tab in the integrations page
- 3
Click "Connect to Slack"
You will be redirected to Slack to authorize the app
- 4
Authorize the App
Review the permissions and click "Allow" to grant OKR Studio access to your Slack workspace
- 5
Select Default Channel
Choose the Slack channel where OKR notifications, summaries, and alerts will be posted
- 6
Save Settings
Click "Save Settings" to activate the integration
OAuth Permissions (Bot Scopes)
The Slack app requests the following bot scopes: commands (slash commands), chat:write (post messages), users:read and users:read.email (match Slack users to accounts), and im:write (send DM reminders). You can revoke access at any time from Slack's App Management page.
Once connected, any team member whose Slack email matches their OKR Studio account can use slash commands in any Slack channel.
/okr checkin
Opens an interactive modal where you can:
- Select a Key Result from your active objectives
- Enter the current value
- Add a comment or notes
- Set a confidence level (On Track, At Risk, Off Track)
After submission, a confirmation message is posted to the channel.
/okr summary
Shows an ephemeral message (visible only to you) with current cycle progress, including overall percentage, objective breakdown, and Key Result statuses.
/okr status
Shows an ephemeral message (visible only to you) with your personal KR dashboard:
- Only Key Results you own across all active objectives
- Progress bars for each Key Result
- Current value vs target value
/okr list
Shows an ephemeral message (visible only to you) with all active OKRs:
- All objectives and Key Results grouped by team
- Progress bars and status indicators
- Owner information for each item
/okr help
Lists all available slash commands and their descriptions.
The integration automatically sends notifications to your configured default channel and direct messages to individual team members.
Weekly Summary
Posted every Monday at 9:00 AM UTC to the default channel. Includes overall progress percentage and a breakdown for each objective with progress bars.
At-Risk Alerts
Sent daily at 9:00 AM UTC to the default channel. Lists Key Results that are below 50% progress relative to their target.
Check-in Reminders
Sent as DMs to team members who haven't updated their Key Results in over 7 days. Includes a prompt to use /okr checkin.
Check-in Confirmations
When a check-in is submitted via the /okr checkin command, a confirmation message is posted to the channel with the updated progress.
The Slack integration matches Slack users to OKR Studio accounts using email addresses. When a user types a slash command, the integration looks up their Slack email and finds the corresponding OKR Studio account in the connected organization.
Important
- • Each team member's Slack email must match their OKR Studio email
- • If emails don't match, users will see an error when using slash commands
- • Admins should verify email consistency before rolling out the integration