Docs
Microsoft Bookings, documented
An independent reference for Microsoft Bookings: what each setting does, its defaults and the limits Microsoft does not spell out. Below it, the developer docs for the BookingsXP widget, webhooks and API.
Microsoft Bookings
Overview
What Bookings is, where you use it and the limits that apply.
- Microsoft Bookings: what it is and how it worksWhat Microsoft Bookings is, how shared booking pages and Bookings with me work, where bookings land in Outlook and Teams, who can book, and a map of these docs.
- Microsoft Bookings login: web, Outlook, Teams, mobileWhere to sign in to Microsoft Bookings: the book.ms web app, the Bookings app in Outlook and Teams, what replaced the mobile app, and fixes if it won't open.
- Microsoft Bookings limits: every documented quotaEvery limit Microsoft documents for Bookings in one table: staff, services, booking window, exports, Power Automate and Graph, with sources and contradictions.
Bookings with me
Personal booking pages in Outlook: meeting types, links and sharing.
- Bookings with me in Outlook (Personal Bookings)How Bookings with me works in Outlook: who gets it, where it lives in each Outlook, public vs private meeting types, what bookers see and where its limits are.
- Bookings with me meeting types: every settingEvery Bookings with me meeting type setting in one table: duration, Teams, hours, buffers, lead time, increments, reminders and visibility, with defaults.
- Sharing your Bookings with me page: links and signatureEvery way to share a Bookings with me page: link formats, single meeting types, private and single-use links, the signature, email, and what each exposes.
Shared Bookings
Shared booking pages: services, staff, scheduling rules, emails and the page itself.
- Shared booking pages: setup and the mailbox behind themWhat a Microsoft Bookings shared booking page is, who can create one, the Exchange mailbox it creates, each business information field and the defaults.
- Services in Microsoft Bookings: every settingEvery Microsoft Bookings service setting in one place: duration, buffers, price, Teams, capacity, staff, questions, reminders, policy overrides, publishing.
- Staff in Microsoft Bookings: roles, hours, notificationsHow staff work on a Microsoft Bookings shared page: roles, internal and external staff, membership approval, working hours, calendar sync, alerts and limits.
- Scheduling policy in Microsoft BookingsEvery scheduling policy setting on a Microsoft Bookings shared page: increments, lead time, booking window, notifications, staff choice and service overrides.
- How Microsoft Bookings calculates availabilityThe order Microsoft Bookings applies business hours, staff hours, Outlook free/busy, time off, lead time, buffers and time zones, plus a symptom table.
- Group services and attendee limits in Microsoft BookingsHow Microsoft Bookings group services work: maximum attendees, why the field is greyed out, how capacity is counted, managing attendees and known limits.
- Custom questions in Microsoft BookingsEvery Microsoft Bookings form field: built-in customer fields, the two question types, required vs optional, the shared list, limits and where answers go.
- Customers and manual bookings in Microsoft BookingsHow the Microsoft Bookings customer list fills up, import, export and bulk delete, booking for a customer, self-service changes and the email code.
- Emails, reminders and SMS in Microsoft BookingsEvery message Microsoft Bookings sends, who gets it and when, what you can change, the sender address, SMS licence and country rules, and why emails go missing.
- Microsoft Bookings page: customize and publishEvery Bookings booking page setting: theme, logo, language, time zone, URL, custom domain, who can book, indexing and publishing, with defaults and limits.
- Teams meetings in Microsoft BookingsHow Microsoft Bookings adds Teams meetings, how customers join in a browser, the Bookings app in Teams, and what Teams Premium adds to virtual appointments.
- Microsoft Bookings reporting and exportsEvery report Microsoft Bookings has: the Home page, the four-month TSV export, Teams Premium appointment reports, Graph, and what you can't measure natively.
Admin
Tenant and user controls, and the PowerShell behind them.
- Microsoft Bookings admin controlsEvery admin control for Microsoft Bookings: tenant on/off, per-user access, Bookings with me, the granular controls, domains, deletion and migration.
- PowerShell for Microsoft Bookings adminsThe documented PowerShell for Microsoft Bookings: every Bookings parameter on Set-OrganizationConfig and Set-OwaMailboxPolicy, plus mailbox cmdlets for pages.
Integrations & API
Microsoft Graph, the Power Automate connector and what else connects.
- Microsoft Graph Bookings API: what it can and can't doThe Microsoft Graph Bookings API by resource: v1.0 vs beta, permissions, clouds, throttling, a first request and the gaps, like no webhooks or Bookings with me.
- Microsoft Bookings connector for Power AutomateEvery trigger and action in the Microsoft Bookings (Preview) connector, its licence class, the 5-flow and admin-only limits, known issues and common flows.
- Microsoft Bookings integrations: Zoom, CRMs, ZapierWhat connects to Microsoft Bookings: Outlook and Teams natively; Zoom, HubSpot, Salesforce, Dynamics, Google Calendar, Zapier and analytics by workaround.
- Microsoft Bookings on your website: every embed optionEvery way to put a Microsoft Bookings page on your site: links, the iframe, SharePoint, WordPress, site builders, Bookings with me and custom front ends.
- Microsoft Bookings conversion tracking: what worksWhat Microsoft Bookings tracks natively (only RefID), why an iframe blocks GA4, GTM and pixels, and each route for UTMs, ads, Clarity and the funnel.
Troubleshooting
Symptoms, their usual causes and the page that fixes each.
BookingsXP developer docs
BookingsXP sits in front of your Microsoft Bookings page. Microsoft still holds every booking. One script per page and one element where the widget should appear: the link-only form needs no account, and 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.
- QuickstartPut a BookingsXP widget on your site in a few minutes. Paste your Microsoft Bookings link, or use a saved widget, as inline, popup or floating.
- Profile, photo and hosted page designAdd a photo, bio, highlights and links to a BookingsXP widget, pick a hosted page layout, and upload your own logo or cover image.
- Workspace defaultsSet brand, tracking, privacy and indexing once for every BookingsXP widget, and override a section for one widget when it needs to differ.
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.
- JS API & eventsControl BookingsXP widgets from JavaScript with render, open, on and scan, and listen for booking events as DOM CustomEvents or callbacks.
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.
- REST APIRead widgets, stored bookings and funnel analytics from the BookingsXP REST API with a Bearer key. Parameters, cursor pagination, errors and examples.
- Privacy & dataWhat the BookingsXP widget reads, stores and sends, how GPC and window.bxpConsent limit attribution, the Store bookings switch, erasure and retention.
- Zero data retentionTurn on zero data retention so BookingsXP stores no bookings or per-visit data. What it deletes, what pauses, what keeps working and how to turn it off.
Platforms
Components for React, Vue, Svelte, Astro and WordPress.
- React, Next.js, Vue, Svelte and AstroUse BookingsXP in React, Next.js, Vue, Svelte and Astro. The script embed works today; the component packages and their props are npm release pending.
- WordPress pluginInstall the BookingsXP WordPress plugin, then add your BookingsXP widget with a block or the [bookingsxp] shortcode, or a floating button site-wide.
Missing something or found a mistake? Write to hello@bookingsxp.com.