Boulevard API
Boulevard is a client experience platform for appointment-based beauty and wellness businesses—salons, medspas, spas, and barbershops—covering self-booking, scheduling, point of sale, payments, client management, memberships, and marketing. Its Open API lets you programmatically pull appointments, clients, staff, services, inventory, and sales—and push updates like new bookings, client records, and checkouts back into Boulevard.
What is Boulevard?
Boulevard is a client experience platform built specifically for appointment-based beauty and wellness businesses—salons, medspas, spas, barbershops, nail salons, and multi-location and franchise operations. Businesses use Boulevard to power self-booking and calendar optimization, run an all-in-one point of sale, manage client profiles, sell memberships and packages, send marketing and messaging campaigns, capture forms and charts, and process payments from a single dashboard.
Core product areas include:
- Precision Scheduling and self-booking (calendar optimization and online appointment booking)
- All-in-one POS, payments, and checkout
- Client management and profiles
- Memberships, packages, and loyalty programs
- Marketing, messaging, forms, and charts
- Reporting, analytics, and Boulevard AI
Common data entities:
- Appointments, Bookings, Availability, Calendars
- Clients, Profiles, Memberships, Packages
- Staff, Services, Locations, Resources
- Orders, Sales, Payments, Inventory, Products
- Forms, Charts, Marketing Campaigns, Rewards
The Boulevard Integration Challenge
Salons, spas, and medspas run their day-to-day operations on Boulevard, but turning that activity into reliable API-driven automation is non-trivial:
- Enterprise-tier gating: Boulevard's Open API is available on the Enterprise tier only, so smaller and mid-market locations often can't reach it directly
- App provisioning flow: Access requires creating and installing an application in the developer portal, then managing an API key and app secret per business
- GraphQL surface differences: The Client API, Admin API, and Tokenization API each expose distinct schemas, scopes, and mutation patterns
- Multi-location complexity: Franchise and multi-location operators have per-location staff, services, inventory, and calendars that must be reconciled
- Payment and tokenization sensitivity: Capturing card and sensitive client data flows through the Tokenization API and demands careful, compliant handling
- Webhook plumbing: Event flows—like appointment completion or rewards earned—require wiring and reconciliation against the Admin API
How Supergood Creates Boulevard APIs
Supergood reverse-engineers authenticated dashboard flows and Boulevard's GraphQL Admin, Client, and Tokenization APIs to deliver a resilient API layer for your Boulevard account—regardless of plan tier or number of locations.
- Handles dashboard credentials, app key/secret provisioning, and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across appointments, clients, staff, services, inventory, and sales so you integrate once and rely on consistent objects
- Reconciles per-location data for multi-location and franchise operators and respects your account's entitlements
Use Boulevard with AI agents: Boulevard MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your locations, plan tier, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Boulevard adapter tailored to your account and locations.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Boulevard evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Boulevard account using dashboard credentials or an app key/secret and obtain a session token for downstream calls.
Scheduling
/appointmentsList appointments and bookings across locations with filters for staff, service, client, status, and date range.
Scheduling
/create_appointmentCreate a new booking against available staff, service, and calendar slots.
Clients
/clientsRetrieve client profiles, memberships, packages, and visit history with search and filter parameters.
Catalog
/servicesPull the service menu, staff assignments, locations, and resource availability.
Sales
/ordersRetrieve orders, sales, payments, and inventory movements from the point of sale across locations.
Use Cases
Sync appointment and client data into your warehouse
- Pull appointments, bookings, and availability across all locations into a single warehouse - Stream completed-visit and rewards-earned events to downstream BI and CRM tools - Reconcile client profiles, memberships, and packages for a unified customer 360
Automate booking and calendar workflows
- Create and modify bookings programmatically against staff and service availability - Sync calendars and resources across multi-location and franchise operations - Trigger reminder and rebooking flows without dashboard clicks
Reconcile sales, payments, and inventory
- Sync orders, payments, and disbursements from the POS into accounting and AR systems - Track inventory and product movements across locations - Surface membership and package consumption to revenue reporting
Power marketing and loyalty automation
- Push client and visit data into marketing, messaging, and loyalty platforms - Segment clients by service history, spend, and membership status - Trigger campaigns when appointments complete or rewards are earned
Technical Specifications
Authentication
Dashboard credentials, app key/secret, and MFA handled in a managed session
Connectivity
Authenticated dashboard flows plus Boulevard's GraphQL Admin, Client, and Tokenization APIs where exposed by the account
Response format
Normalized JSON across appointments, clients, staff, services, inventory, and sales objects
Rate limits
Adaptive throttling tuned to your account to avoid Boulevard-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for appointments, clients, and sales with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for appointment completion, rewards earned, client changes, and sales
Latency
Sub-second reads on cached entities; multi-second writes when posting bookings and checkouts
Throughput
Horizontally scaled workers sized to multi-location appointment and sales volume
Reliability
Retry, backoff, and idempotency keys for bookings, payments, and inventory transactions
Adaptation
Continuous monitoring of Boulevard releases and account-specific configuration drift
Frequently asked questions
No. Boulevard's Open API is Enterprise-tier only, but Supergood works against your existing authenticated dashboard surfaces as well, so you can automate Boulevard workflows regardless of plan tier.
Supergood normalizes data across Boulevard's GraphQL Admin API, Client API, and Tokenization API, exposing appointments, clients, staff, services, inventory, and sales through one consistent surface.
Yes. Per-location staff, services, calendars, inventory, and sales are reconciled into a unified API so multi-location and franchise operators integrate once across all sites.
Card and sensitive client data flows through Boulevard's Tokenization API and is handled with encrypted credential storage, scoped tokens, and SOC 2-aligned controls.
Yes. Webhook-style callbacks for events like appointment completion and rewards earned are surfaced alongside near real-time pulls, with optional scheduled batch syncs.