Skip to main content

Developer documentation

License required

This section is for customers with an active WooCommerce Appointments license. You reached it after signing in at Developer login.

Evaluating the product? Start with the public Developers overview.

Terminology

Merchant docs use appointable product (the WooCommerce product type label). REST/API responses use product_id on products with type: appointment. Same bookable product; different labels by audience.

Extend WooCommerce Appointments with the REST API, WordPress hooks, webhooks, and storefront customization. Prefer v2 (/wp-json/wc-appointments/v2/) for new work.

Start here​

GoalGo to
Authenticate and make a first requestAuthentication
Create, list, or update appointmentsAppointments (start / end fields)
Build a custom booking UISlots · AJAX
Recurring packages (5.4+)Series
Locations & rooms (5.5+)Locations & resources
Change PHP behaviorHooks & filters
React to create/update eventsWebhooks
Live admin calendar updatesSSE
Form layout, CSS, GCal edge casesCustomization recipes

REST API​

Base URL:

https://your-site.com/wp-json/wc-appointments/v2/
ResourceTypical use
AppointmentsCRUD for bookings
SeriesRecurring packages (5.4+)
SlotsAvailable times for a product
CalendarSame feed as Appointments → Calendar
Availabilities · Staff · ProductsRules and catalog behind the booking form
SSEServer-sent events for the admin calendar

Extending in PHP and JS​

SurfaceWhen to use
Hooks & filtersStatuses, availability, emails, Google Calendar, series, cart
WebhooksPush appointment events to an external URL
EmailsTemplate overrides and email classes
Style the appointment formCSS and template paths
Where to add code

Use a child theme functions.php or a small site-specific plugin. Do not edit plugin files. See Where to add code.

Architecture notes​

Read these when integrating schedule or staff logic:

Getting help​