Set up your first on-call rotation in Slack
Install OnCallManager, choose your responders, and publish your first schedule. Calendar sync, notifications, and AI features can come later.
14-day free trial. No credit card required.
Setup Guide: Create your first rotation and go live fast
Already have a PagerDuty schedule? Start with the PagerDuty Sync section. For a new Slack-managed rotation, start with Getting Started and Publishing Your First Rotation below. Once your schedule is live, use the later sections to configure overrides, calendar sync, notifications, and AI auto-answering.
Getting Started
Before installing: you need a paid Slack plan with user groups. Your workspace admin may need to approve the app and user-group access. OnCallManager’s 14-day trial does not include a Slack subscription.
Step 1: Install OnCallManager
- Click "Add to Slack and Start Setup"
- Review the scheduling permissions and authorize the app for your workspace. Installation does not request message access. Scheduling, notifications, overrides, and calendar integration work without it; choose “Enable Slack auto-answer” later to authorize message access separately.
- Once installed, find OnCallManager in your Slack apps
Step 2: Access the App Home
Open Slack and click on "OnCallManager" in your apps list. The app home is where you'll create and manage all your on-call rotations.
Creating and Managing Rotations
Publishing Your First Rotation
- Open OnCallManager’s Home tab and click “Publish first schedule”
- Start with yourself or use “Edit Users” to add teammates
- Choose the rotation cadence, handoff days, and time
- Enter the group name your team will use to contact the on-call responder
- Check the responders, handoff times, and timezone in the preview
- Click “Publish” and confirm your schedule appears on the Home tab
Already have a schedule? Click “New Schedule” and finish with “Submit.” Notification channels are optional. You can add Google Calendar and AI features after publishing.
Editing or Deleting Rotations
To modify an existing rotation:
- Find the rotation on the app home page
- Click the overflow menu (three dots)
- Select "Edit" to modify settings or "Delete" to remove
Overriding Shifts
When team members need to swap shifts:
- Open the rotation's overflow menu
- Select "Override on-call"
- Choose the shifts you want to override
- Select the replacement team member
- Click "Apply" to confirm
Learn more about managing fair rotations in our rotation scheduling guide.
Connect an existing PagerDuty schedule
Keep managing shifts and overrides in PagerDuty. OnCallManager periodically updates a Slack user group with the current responders; you do not need to recreate the schedule.
- Install OnCallManager and open its Home tab in the intended Slack workspace.
- Select Connect PagerDuty and complete PagerDuty authorization. Return to App Home and select Add PagerDuty Sync.
- Choose the PagerDuty schedule, enter a Slack usergroup handle and select Enable. Notification channels are optional. Prefer a dedicated handle; an existing group's membership will be managed by this schedule. A PagerDuty schedule can have one active sync connection in your workspace.
- After a successful sync, compare the group's actual members with PagerDuty's current responders. Check again at the next handoff. Test overrides on a dedicated test schedule.
If sync needs attention
- Unmatched responders: fix mismatched email addresses. Existing membership is retained until a successful sync; it may be stale.
- Missing Slack permissions: have an admin review user-group access and complete the requested reinstall.
- No schedules or an API error: check PagerDuty access and App Home's error status. Verify coverage directly in PagerDuty while resolving it.
- Intentionally empty schedule: the group is disabled until the next populated shift. This is different from a failed lookup.
- Schedule changes: edit shifts and overrides in PagerDuty. To stop sync, use the schedule's menu and choose Disconnect PagerDuty.
Optional public Google Calendar
Use the schedule's Google Calendar action and review the sharing notice before choosing Create public calendar. It mirrors the next 60 days of computed shifts, including overrides. Anyone with access can see the rotation name, assignee display names and shift times. Disconnecting PagerDuty pauses updates but preserves events and public sharing; it does not make the calendar private.
OnCallManager is $50/month for unlimited users and rotations after a 14-day trial, in addition to your PagerDuty and Slack subscriptions. No credit card required.
Explore PagerDuty syncGoogle Calendar Integration
Create a private Google calendar for each rotation and let your team subscribe. Calendar subscribers do not need to connect Google to OnCallManager.
Creating the Shared Calendar
- Open the rotation’s "Google Calendar" action in Slack and select "Create shared calendar"
- Sign in with the Google account that will own the shared calendar
- Grant permission to create and manage app-created calendars. In Google Calendar sharing settings, add people or Google groups with "See all event details" access.
Subscribing to Rotations
- Open a rotation's overflow menu
- Select "Google Calendar" and ask the owner to share access with you
- Click "Subscribe" on the rotation page to add the shared calendar to Google Calendar
Note: Pausing sync retains the shared calendar, events, and subscribers. After the first successful shared sync, tracked ongoing and future personal events are removed; past events remain. If cleanup needs reconnection, the rotation page shows an action for the original event owner. Existing ICS subscriptions remain separate and unchanged.
AI Auto-Answering
With optional message access granted, AI auto-answering lets teammates ask a rotation operational questions in public channels the app has joined and get a reply in-thread. You can grant access later with “Enable Slack auto-answer” in App Home or on a rotation page. Google Gemini generates the answer using knowledge retrieved for that specific rotation instead of a generic workspace-wide search.
Generated answers may be inaccurate. Verify important operational steps against the linked source documentation before acting.
How it works
- Someone mentions the rotation handle in Slack with a question
- OnCallManager searches that rotation's linked docs and prior conversations
- The app replies in the same thread so responders can confirm or refine the answer
How to set it up well
- Create the rotation first so the handle exists in Slack
- Click Manage Knowledge Base on that rotation
- Link the runbooks, SOPs, and incident notes responders actually use
- Keep the docs concise and operational so the AI can retrieve the right steps quickly
For the detailed flow and usage patterns, see the AI auto-answering guide.
Notifications & Group Updates
Automatic Group Updates
OnCallManager automatically updates the Slack user group associated with your rotation when shifts change. This ensures that @mentioning your on-call group always reaches the current on-call person.
Channel Notifications
If you've set a notification channel for your rotation:
- A message is sent when a new rotation is created
- Shift change notifications are posted when the on-call person changes
- Override notifications announce temporary coverage changes
For tips on handling incidents effectively, see our incident response guide.
Need help after you install?
If you want a hand with your first schedule, we can help you get the initial rotation live quickly.