GRP

Calendar Groups

Calendars & Scheduling · Intermediate · Updated March 2026

Manage calendar groups for organizing multiple calendars under a single booking page. Includes slug validation, status toggling, and group CRUD.

When a business offers multiple services or has multiple team members with their own calendars, a calendar group presents them all under a single booking page. The visitor picks what they need, and the system routes them to the right calendar. Managing groups through MCP means you can programmatically configure multi-service booking experiences during client onboarding.

What This MCP Tool Does

Create, update, delete, and manage calendar groups. Groups organize multiple calendars under a unified booking URL. Includes slug validation to ensure booking page URLs are unique, and status toggling to enable/disable groups without deleting them.

Endpoint Reference

Create a group: POST /calendars/groups Create a new calendar group with a display name, slug, and assigned calendars.

Update a group: PUT /calendars/groups/{groupId} Modify the group name, slug, or calendar assignments.

Delete a group: DELETE /calendars/groups/{groupId} Remove a calendar group. Individual calendars within the group remain intact.

Validate slug: GET /calendars/groups/slug/validate Check whether a booking page slug is available before creating a group.

Toggle status: PATCH /calendars/groups/{groupId}/status Enable or disable the group without deleting it.

Authentication

Requires a Private Integration Token (PIT) with the calendars scope enabled.

Key Parameters

name — group display name shown on the booking page
slug — URL-friendly string for the booking page URL
calendarIds — array of calendar IDs to include in the group
isActive — boolean for enabling/disabling the group

Important Notes

Slugs must be unique within a location. Always validate the slug before creating a group to avoid conflicts.

Disabling a group via status toggle keeps the configuration intact but prevents new bookings. This is useful for seasonal services or temporary unavailability.

The order of calendars within a group determines how they display on the booking page. Consider this when building multi-service booking experiences.

Common Questions

What does a calendar group look like to the visitor? A single booking page that lets the visitor select which service or team member they want before showing available time slots.

Can a calendar belong to multiple groups? Yes. The same calendar can be included in multiple groups.

How do I reorder calendars within a group? The order of the calendarIds array determines display order. Update the group with the IDs in your desired sequence.

Calendar CRUD — Create the calendars that go into groups
Free Slots — Check availability for calendars within a group
Appointment CRUD — Book appointments through grouped calendars
Calendar Notifications — Set reminders per calendar in the group
Location CRUD — The location containing the calendar groups