Services Catalog
The Services catalog provides a comprehensive solution for managing service-based businesses such as salons, spas, clinics, consultants, and repair or professional services. Customers discover your services online, ask questions, see real availability, and book — and your team manages it all from one structured catalog.
What it supports
- Service catalog management with categories, pricing, and availability
- Service providers (staff) with skills, schedules, and commission tracking
- Appointment booking with calendar integration and multi-channel support
- Dynamic field configurations for customizable booking forms
- Provider time-off management with recurring and one-time entries
- Pricing rules for promotions and conditional discounts
- Slot availability queries for real-time booking
- External calendar sync (Google, Outlook, Calendly)
How the catalog fits together
A category groups your services. Each service is the offering customers book — it carries its own availability, duration, and booking rules. A provider assignment links a service to the person (staff member) who performs it, with optional per-provider price and duration overrides.
| Concept | What it is |
|---|---|
| Business service | A service offering with pricing, duration, and booking rules |
| Service category | A grouping of related services for organization and display |
| Service person | A staff member who performs services |
| Service provider | A link between a service and a person, with optional overrides |
| Service appointment | A scheduled booking for a service |
| Appointment fields | Customizable booking-form fields captured per appointment |
| Service pricing rule | Conditional pricing and promotions |
How a booking works
An appointment is where the catalog turns into revenue. The agent (or your app) checks real availability, captures the details you ask for, applies any pricing rules and deposit, books the slot, and syncs it to the provider's calendar — then the appointment moves through its lifecycle.
Why it matters
- For the offering — model a service once (price, duration, buffers, deposit, booking window) and it powers your web catalog, your AI agents, and your booking flow with the same accurate data.
- For availability — slot queries reflect real provider schedules and time off, so customers only ever see and book genuinely open times.
- For the booking — appointments capture the customer details you define, apply promotions and deposits automatically, and sync to Google, Outlook, or Calendly — turning a conversation into a confirmed, calendared appointment.
- For the business — per-provider price/duration overrides, commission tracking, and no-show / late-cancel fees are built in, so the catalog reflects how you actually operate.
What you can build
- An online booking experience grounded in real availability
- AI agents that answer service questions and book appointments in conversation
- Multi-provider scheduling with per-provider price and duration overrides
- Promotions such as happy-hour discounts and bundle pricing
Enums quick reference
| Enum | Values |
|---|---|
| ServicePriceMode | FIXED, STARTS_AT, VARIABLE |
| ServiceGratuityMode | NONE, OPTIONAL, REQUIRED |
| ServiceAvailabilityMode | ALWAYS, SCHEDULED, INHERIT |
| ServiceDepositStrategy | NONE, FIXED, PERCENTAGE |
| AppointmentStatus | pending, confirmed, completed, cancelled, no_show |
| CalendarProvider | google, outlook, calendly |
SDK parity matrix
This reflects what the SDK example guides demonstrate for each language.
| Area | Operations | TypeScript | Python |
|---|---|---|---|
| Business services | create, get, list, update, delete, batch | ✓ | ✓ |
| Service categories | create, get, update, list, delete | ✓ | — |
| Service providers | persons, assignments, time off | ✓ | — |
| Appointments | create, get, get by customer, get by service, update status, cancel, reschedule | ✓ | ✓ |
| Appointments | slot query, list, get by provider, get by date range, delete | ✓ | — |
| Appointment fields | configs (schema reference) | ✓ | — |
| Pricing rules | rules (schema reference) | ✓ | — |
Pages
- Services & categories — define and organize offerings
- Service providers — staff, assignments, and time off
- Appointments — slot queries, booking, and lifecycle
- Appointment fields — customizable booking forms
- Pricing rules — promotions and conditional pricing
- Quickstart — an end-to-end booking flow
Next steps
Start with Services & categories, or jump to the Quickstart for an end-to-end booking flow.