Developer docs
Build with BookingsXP
BookingsXP sits in front of your Microsoft Bookings page. Microsoft still holds every booking; these docs cover the widget, its events, webhooks and the API.
The whole install
One script per page, one element where the widget should appear. The link-only form needs no account; a saved widget adds your template, tracking IDs and a dashboard.
<script src="https://bookingsxp.com/embed/v1.js" async></script>
<bookingsxp-widget booking-url="https://outlook.office.com/book/Contoso@contoso.com/"></bookingsxp-widget>
<!-- or, with a free account: <bookingsxp-widget widget="w_8fk2m1qz"></bookingsxp-widget> -->Get started
Put a working widget on a page in a few minutes.
Embed
Every attribute, the JavaScript API and the events it emits.
- Embed attributesEvery attribute of the bookingsxp-widget element and its data- form, with defaults, prefill fields and the placeholders for redirect-url.Read
- JS API & eventsControl BookingsXP widgets from JavaScript with render, open, on and scan, and listen for booking events as DOM CustomEvents or callbacks.Read
Tracking
Send bookings to Tag Manager, GA4 and ad platforms.
Data & API
Webhooks, the REST API and what BookingsXP stores.
- WebhooksReceive signed JSON webhooks for new and failed bookings, verify BookingsXP-Signature, handle retries, and post alerts to Slack or Microsoft Teams.Read
- REST APIRead widgets, stored bookings and funnel analytics from the BookingsXP REST API with a Bearer key. Parameters, cursor pagination, errors and examples.Read
- Privacy & dataWhat the BookingsXP widget reads, stores and sends, how GPC and window.bxpConsent limit attribution, the Store bookings switch, erasure and retention.Read
Platforms
Components for React, Vue, Svelte, Astro and WordPress.
- React, Next.js, Vue, Svelte and AstroEmbed the BookingsXP widget with the React, Vue 3, Svelte 5 and Astro components, including Next.js App Router usage, event callbacks and baseUrl.Read
- WordPress pluginInstall the BookingsXP WordPress plugin, then add your Microsoft Bookings widget with a block or the [bookingsxp] shortcode, or a floating button site-wide.Read
Missing something or found a mistake? Write to hello@bookingsxp.com.