On-call
An on-call schedule decides which team member is on call at each moment. A schedule has rotation layers that hand off between members, overrides for swaps and holidays, and cover requests when someone cannot do a shift. A Notify on-call step in an escalation path pages whoever is on call when the step runs. It can also page whoever is on call next, or everyone on the schedule. On-call schedules are part of the Team and Business plans.
Create a schedule
- In the dashboard, select Alerting → On-call.
- Select New schedule.
- Enter a Name, for example
Platform on-call. The Description is optional. - Select the Time zone. Handoffs and set hours use this time zone.
- Select Create schedule.
A new schedule has nobody on call. Add a rotation next.
Add a rotation
A rotation is a layer of the schedule. It hands off between its participants in order, at a fixed interval.
- Open the schedule.
- Select Add rotation.
- Enter a Name, for example
Primary. - Under Participants, add team members in the order of their turns.
- Under Hand off every, enter a number and select Hours, Days or Weeks.
- Enter the date of the First handoff and the Handoff time.
- Select Add rotation.
The first participant's turn starts at the first handoff. After each interval, the next participant takes over. After the last participant, the first one starts again.
| Setting | API field | Values |
|---|---|---|
| Participants | participants | 1 to 50 team members, in order |
| Hand off every | shift_length, shift_unit | 1 to 720 hours, 1 to 90 days, or 1 to 12 weeks |
| First handoff | start_date | A date, YYYY-MM-DD, in the schedule's time zone |
| Handoff time | handoff_time | A time, HH:MM, in the schedule's time zone |
| Only cover set hours | restrictions | Optional days and a time window, see below |
days and weeks follow the calendar in the schedule's time zone. The handoff stays at the same clock time when daylight saving time starts or ends. hours are exact hours, so a 12-hour shift is always 12 hours long.
Cover set hours only
Select Only cover set hours to limit a rotation to some days and times, for example weekdays from 09:00 to 17:00. Outside these hours, the layers below take over, or nobody is on call. If Until is earlier than From, the window runs overnight.
Layers
A schedule can have more than one rotation. The dashboard shows them under Rotation layers. Where layers overlap, the top layer wins. Use this to combine a business-hours rotation on top of a round-the-clock rotation.
You can change the order of the layers. Spectate skips a participant who is no longer a member of the team.
Add an override
An override puts one member on call for a period, over all layers. Use it for swaps, sick days and holidays.
- Open the schedule.
- Select Override.
- Under Who covers, select the team member.
- Enter From and Until in the schedule's time zone.
- Optional: enter a Note, for example
Swapping with Bob for the release. - Select Add override.
An override is at most 90 days long. Where overrides overlap, the newest override wins. The Overrides panel shows upcoming and active overrides.
Ask for cover
A cover request asks the other members of a schedule to take a shift of yours. The first member to accept gets an override for the whole window. Nothing changes on the schedule until someone accepts.
- Select Alerting → On-call.
- Under Your on-call, select Request cover next to the shift.
- Change From and Until if you need cover for part of the shift only.
- Optional: enter a Note, for example the reason.
- Select Ask for cover.
In Slack or Discord, use /spectate cover. See cover requests in Slack and Discord.
Spectate asks every other member of the schedule's rotations. If the team connected Slack or Discord, members that Spectate reaches there get a direct message with Accept and Can't cover. Other members get an email. They answer under Your on-call, or on the schedule page under Waiting for cover.
These rules apply:
- You must be on call for all of the window. A window that already started covers the rest of it.
- A window is at most 90 days long. You can have one open request for the same time.
- Any member of the team can accept, also a member that Spectate did not ask. You cannot accept your own request.
- If someone accepts, Spectate tells you. If everyone says they cannot, Spectate tells you too, and the request stays open. A member who said no can still accept.
- Send reminder asks again the members who did not answer, at most every 30 minutes.
- If nobody accepts before the window ends, the request expires. You stay on call.
- You can cancel your own request. Owners, managers and admins can cancel any request.
The public API and the MCP server do not have cover requests yet.
See who is on call
The schedule page shows On call now, the Next handoff and a Timeline of 1 week or 2 weeks. The timeline has a row for each layer, a row for overrides, and the Final schedule row. The Final schedule is who Spectate pages.
The On-call page lists all schedules with the person on call now. Your on-call shows your own shifts for the next 14 days.
With the public API, GET /v1/on-call-schedules/{schedule}/now returns who is on call, and GET /v1/on-call-schedules/{schedule}/timeline returns the shifts for a period.
Add shifts to your calendar
You can see on-call shifts in Google Calendar, Apple Calendar, Outlook or any other app that can subscribe to an iCalendar URL. There are two kinds of URL:
- Your own shifts: on the On-call page, under Your on-call, select Add to calendar. The URL has your shifts in all schedules of the team.
- Everyone's shifts on a schedule: on the schedule page, select Add to calendar. Each shift shows the name of the member. An owner, a manager or an admin creates this URL. Every member can then copy it.
To add a URL:
- Select Add to calendar.
- Select Create URL.
- Select Open in calendar app, or copy the URL into your calendar app. In Google Calendar, go to Other calendars → From URL.
The calendar has shifts from 30 days ago to 90 days ahead. Times are in UTC, so your calendar app shows them in your own time zone. Shifts do not show you as busy.
Your calendar app decides how often it reads the URL. Google Calendar can take up to a day, so a late change to a shift can show late in the calendar. Spectate pages from the schedule, not from the calendar.
Anyone with the URL can see the shifts, without a sign-in. To replace a URL, select Add to calendar → New URL. To stop it, select Stop URL. The old URL stops working at once.
If a member leaves the team, the URL of their own shifts stops working.
Page the person on call
- Open an escalation path.
- Add a Notify on-call step.
- Under Schedule, select the on-call schedule.
- Under Page, select Whoever is on call, Whoever is on call next or Everyone on the schedule.
- Optional: under Rotation, select one rotation.
- Select Save flow.
Spectate finds the people to page when the step runs, not when the alert fires. If nobody is on call, Spectate skips the step and runs the next step at once. The alert's Escalation panel shows who Spectate paged, and how, or why it skipped the step. Use Whoever is on call next in a later step as a backup, for when the first member does not acknowledge.
The schedule page shows the escalation paths that use the schedule under Used by.
How Spectate pages a member
Spectate pages each member by their own notification rules, in Account → Notifications. A rule is a method and a time, for example "the Spectate app immediately, a phone call after 2 minutes if not acknowledged". The methods are email, the Spectate app, Slack or Discord, Telegram, SMS and phone call. SMS and phone calls use the team's SMS and call credits.
Each member adds their phone number in Account → Profile → Phone. Your on-call on the On-call page shows a summary of your rules. See Telegram and phone for the voice call.
If you can't take a page
A paged member can say "not me" on the alert page, in Slack, in Discord, in Telegram, or by pressing 2 on a phone call. See Say "not me". To pause the page for a time, snooze the alert. To pull in someone else, use Page someone.
Shift messages
If the team connected Slack or Discord, or a member uses the Spectate app, Spectate sends each member a reminder before a shift. It also sends a message when the shift starts and ends. The reminder has a Request cover button. Each member chooses the time of the reminder in Account → Notifications → Shift messages. See notification rules.
On the schedule page, the Slack panel has two more options:
- Handover channel announces each handover in a Slack channel.
- Keep an on-call user group creates a Slack user group, for example
@platform-oncall. Spectate keeps it set to whoever is on call, or to everyone on the schedule.
The Discord panel has the same options: a Handover channel, and Keep an on-call role, which gives a Discord role to the same people. The panel shows when the team connected Discord.
See on-call in Slack and Discord.
Who can do what
| Action | Owner, manager, admin | Member |
|---|---|---|
| See schedules | Yes | Yes |
| Create and change schedules and rotations | Yes | No |
| Delete schedules | Yes | No |
| Add an override | For any member | For themselves only |
| Remove an override | Any override | Overrides for themselves, or that they added |
| Ask for cover of their own shift | Yes | Yes |
| Accept a cover request | Yes, not their own | Yes, not their own |
| Cancel a cover request | Any request | Their own requests |
| Change the schedule's Slack and Discord settings | Yes | No |
| Create, replace or stop the calendar URL of a schedule | Yes | No |
| Create, replace or stop the calendar URL of their own shifts | Yes | Yes |
Plans
On-call schedules and Notify on-call steps are part of the Team and Business plans, and of the trial. The Starter plan does not include them. See plans and billing and pricing.