Microsoft Bookings integration guide
VerifiedHow to connect Microsoft Bookings to WEXTL and use its 6 triggers and 32 actions in your workflows. About Microsoft Bookings: Microsoft Bookings for appointments and staff calendars.
- 6 triggers
- 12 searches
- 20 actions
- Polling
- Auth: OAuth
AI-assisted documentation20 min read
This documentation is compiled from our integration source code, internal specs for Microsoft Bookings, its official API documentation and anonymized requests logs we collect from our support team[2].
Requirements
Get your Microsoft Bookings credentials
Microsoft Bookings - Secondary
You’ll be redirected to sign in and approve access. Your password is never shared with WEXTL.
- TenantselectRequired
Go to
https://entra.microsoft.comand copy your tennat ID or select any of the following`[1] - Client IDtextRequired
Go to the Microsoft Entra admin center → Entra ID → App registrations and select New registration. → enter a description and expiration → Add, then immediately copy your Client ID[1]
- Client SecretpasswordRequired
Copy you client Secret from the previously created app[1]
Integration requests 6 permissions:
Bookings.Read.AllBookings.ReadWrite.AllBookings.Manage.AllBookingsAppointment.ReadWrite.Alloffline_accessUser.Read
Microsoft Bookings - Primary
You’ll be redirected to sign in and approve access. Your password is never shared with WEXTL.
- TenantselectRequired
Use your tenant ID or primary domain from https://entra.microsoft.com. Application permissions do not work with Common, Organizations or Consumers.[1]
- Client IDtextRequired
Register your application in the Microsoft Entra admin center, then copy the Application (client) ID from the Overview page of the app[1]
- Client SecretpasswordRequired
In your app registration, go to Certificates & secrets → Client secrets, create a new client secret, and copy its value immediately after it's generated.[1]
- Email or User IDtext
Not used by Bookings. Leave blank.[1]
Integration requests 4 permissions:
Bookings.Read.AllBookings.ReadWrite.AllBookings.Manage.AllBookingsAppointment.ReadWrite.All
Connect Microsoft Bookings in WEXTL
- Log in to your WEXTL account, add the Microsoft Bookings node module to your workflow, and click Create new credential.
- Optional: In the Credential name field, enter a name for the credential.
- Enter the authentication credentials you copied from your Microsoft Bookings account, or follow the on-screen instructions to create the credential.
- If prompted, authenticate your account and confirm access.
- If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Microsoft Bookings triggers and actions on WEXTL
The list below is a reference of every Microsoft Bookings node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.
Each Microsoft Bookings node module below opens to reveal its input parameters, outputs, and connection requirements.
Watch Booking Appointments
TriggerScheduled check that emits newly created appointments.
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Anonymous join web URL | text |
| Appointment label | text |
| Created date time | date |
| Customer email address | |
| Customer name | text |
| Customer notes | text |
| Customer phone | text |
| Customers | array |
| Customer time zone | text |
| Duration | text |
| End | object |
| @odata type | text |
| Filled attendees count | text |
| ID | text |
| Is customer allowed to manage booking | text |
| Is location online | text |
| Join web URL | url |
| Last updated date time | date |
| Maximum attendees count | text |
14other output fields
Watch Booking Businesses
TriggerScheduled check for fresh booking businesses.
| Field | Type |
|---|---|
| @odata type | text |
| Address | object |
| @odata type | text |
| Booking page settings | object |
| @odata type | text |
| Business hours | array |
| Business type | text |
| Created date time | date |
| Default currency iso | text |
| Display name | text |
| ID | text |
| Is published | text |
| Language tag | text |
| Last updated date time | date |
| Phone | text |
| Public URL | url |
| Scheduling policy | object |
| @odata type | text |
| Web site URL | url |
Watch Booking Customers
TriggerPolls for freshly saved customers.
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Watch Booking Questions
TriggerPolls the booking form for fresh questions.
| Field | Type |
|---|---|
| @odata type | text |
| Answer input type | text |
| Answer options | array |
| Created date time | date |
| Display name | text |
| ID | text |
| Last updated date time | date |
Watch Booking Services
TriggerPolls for services added to the business.
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Created date time | date |
| Custom questions | array |
| Default duration | text |
| Default location | object |
| @odata type | text |
| Default price | text |
| Default price type | text |
| Default reminders | array |
| Description | text |
| Display name | text |
| ID | text |
| Is anonymous join enabled | text |
| Is customer allowed to manage booking | text |
| Is hidden from customers | text |
| Is location online | text |
| Language tag | text |
| Last updated date time | date |
| Maximum attendees count | text |
| Notes | text |
6other output fields
Watch Booking Staff Members
TriggerPolls for people newly added to the team.
| Field | Type |
|---|---|
| @odata type | text |
| Availability is affected by personal calendar | text |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Is email notification enabled | text |
| Last updated date time | date |
| Role | text |
| Time zone | time |
| Use business hours | text |
| Working hours | array |
List Booking Appointments
SearchAppointments with customer and timing details.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Limit | number |
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Anonymous join web URL | text |
| Appointment label | text |
| Created date time | date |
| Customer email address | |
| Customer name | text |
| Customer notes | text |
| Customer phone | text |
| Customers | array |
| Customer time zone | text |
| Duration | text |
| End | object |
| @odata type | text |
| Filled attendees count | text |
| ID | text |
| Is customer allowed to manage booking | text |
| Is location online | text |
| Join web URL | url |
| Last updated date time | date |
| Maximum attendees count | text |
14other output fields
List Booking Businesses
SearchBooking businesses you can reach in Microsoft Bookings.
| Field | Type |
|---|---|
| Search Query | text |
| Limit | number |
| Field | Type |
|---|---|
| @odata type | text |
| Address | object |
| @odata type | text |
| Booking page settings | object |
| @odata type | text |
| Business hours | array |
| Business type | text |
| Created date time | date |
| Default currency iso | text |
| Display name | text |
| ID | text |
| Is published | text |
| Language tag | text |
| Last updated date time | date |
| Phone | text |
| Public URL | url |
| Scheduling policy | object |
| @odata type | text |
| Web site URL | url |
List Booking Customers
SearchSaved customers and their contact details.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Limit | number |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
List Booking Questions
SearchCustom questions defined for a booking business.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Limit | number |
| Field | Type |
|---|---|
| @odata type | text |
| Answer input type | text |
| Answer options | array |
| Created date time | date |
| Display name | text |
| ID | text |
| Last updated date time | date |
List Booking Services
SearchServices offered by a booking business.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Limit | number |
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Created date time | date |
| Custom questions | array |
| Default duration | text |
| Default location | object |
| @odata type | text |
| Default price | text |
| Default price type | text |
| Default reminders | array |
| Description | text |
| Display name | text |
| ID | text |
| Is anonymous join enabled | text |
| Is customer allowed to manage booking | text |
| Is hidden from customers | text |
| Is location online | text |
| Language tag | text |
| Last updated date time | date |
| Maximum attendees count | text |
| Notes | text |
6other output fields
List Booking Staff Members
SearchStaff people with their assigned roles.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Limit | number |
| Field | Type |
|---|---|
| @odata type | text |
| Availability is affected by personal calendar | text |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Is email notification enabled | text |
| Last updated date time | date |
| Role | text |
| Time zone | time |
| Use business hours | text |
| Working hours | array |
Retrieve a Booking Appointment
ActionDetails of one scheduled appointment.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Anonymous join web URL | text |
| Appointment label | text |
| Created date time | date |
| Customer email address | |
| Customer name | text |
| Customer notes | text |
| Customer phone | text |
| Customers | array |
| Customer time zone | text |
| Duration | text |
| End | object |
| @odata type | text |
| Filled attendees count | text |
| ID | text |
| Is customer allowed to manage booking | text |
| Is location online | text |
| Join web URL | url |
| Last updated date time | date |
| Maximum attendees count | text |
14other output fields
Retrieve a Booking Business
ActionSettings and contact details of a single business.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Field | Type |
|---|---|
| @odata type | text |
| Address | object |
| @odata type | text |
| Booking page settings | object |
| @odata type | text |
| Business hours | array |
| Business type | text |
| Created date time | date |
| Default currency iso | text |
| Display name | text |
| ID | text |
| Is published | text |
| Language tag | text |
| Last updated date time | date |
| Phone | text |
| Public URL | url |
| Scheduling policy | object |
| @odata type | text |
| Web site URL | url |
Retrieve a Booking Customer
ActionContact record held for one customer.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Retrieve a Booking Question
ActionOne custom question from a booking business.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Field | Type |
|---|---|
| @odata type | text |
| Answer input type | text |
| Answer options | array |
| Created date time | date |
| Display name | text |
| ID | text |
| Last updated date time | date |
Retrieve a Booking Service
ActionDetails of a single bookable service.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Created date time | date |
| Custom questions | array |
| Default duration | text |
| Default location | object |
| @odata type | text |
| Default price | text |
| Default price type | text |
| Default reminders | array |
| Description | text |
| Display name | text |
| ID | text |
| Is anonymous join enabled | text |
| Is customer allowed to manage booking | text |
| Is hidden from customers | text |
| Is location online | text |
| Language tag | text |
| Last updated date time | date |
| Maximum attendees count | text |
| Notes | text |
6other output fields
Retrieve a Booking Staff Member
ActionProfile details for a single staff person.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Cancel a Booking Appointment
ActionMarks a scheduled appointment as cancelled.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Create a Booking Appointment
ActionNew appointment for a service, with start, end and customer details.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Service IDRequired | choice |
| Customer Email Address | |
| Customer Name | text |
Start DateTimeRequired | object |
DateTimeRequired | date |
| Time Zone | time |
End DateTimeRequired | object |
DateTimeRequired | date |
| Time Zone | time |
| Duration | text |
| Additional Information | text |
| Appointment Label | text |
| Anonymous Join Web URL | url |
| Customer Notes | text |
| Customer Phone | text |
| Customers | array |
| Customer Time Zone | time |
| Filled Attendees Count | number |
| Is Customer Allowed To Manage Booking | boolean |
| Is Location Online | boolean |
| Join Web URL | url |
| Maximum Attendees Count | number |
| Opt-Out Of Customer Email | boolean |
11other input fields
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Anonymous join web URL | text |
| Appointment label | text |
| Created date time | date |
| Customer email address | |
| Customer name | text |
| Customer notes | text |
| Customer phone | text |
| Customers | array |
| Customer time zone | text |
| Duration | text |
| End | object |
| @odata type | text |
| Filled attendees count | text |
| ID | text |
| Is customer allowed to manage booking | text |
| Is location online | text |
| Join web URL | url |
| Last updated date time | date |
| Maximum attendees count | text |
14other output fields
Create a Booking Business
ActionNew business with hours, scheduling policy and contact details.
| Field | Type |
|---|---|
Display NameRequired | text |
Business TypeRequired | text |
| Address | object |
| Street | text |
| City | text |
| State | text |
| Postal Code | text |
| Country Or Region | text |
| Booking Page Settings | object |
| Allow Anonymous Bookings | boolean |
| Is Published | boolean |
| Business Hours | array |
| Default Currency ISO | text |
| Language Tag | text |
| Phone | text |
| Public URL | url |
| Website URL | url |
| Scheduling Policy | object |
| Maximum Advance | number |
| Minimum Lead Time | number |
| Send Confirmations To Owner | boolean |
| Field | Type |
|---|---|
| @odata type | text |
| Address | object |
| @odata type | text |
| Booking page settings | object |
| @odata type | text |
| Business hours | array |
| Business type | text |
| Created date time | date |
| Default currency iso | text |
| Display name | text |
| ID | text |
| Is published | text |
| Language tag | text |
| Last updated date time | date |
| Phone | text |
| Public URL | url |
| Scheduling policy | object |
| @odata type | text |
| Web site URL | url |
Create a Booking Customer
ActionNew customer record with email, name, addresses and phones.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Email AddressRequired | |
| Display Name | text |
| Addresses | array |
| Phones | array |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Create a Booking Question
ActionNew question with an answer type and options.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Display NameRequired | text |
| Answer Input Type | choice |
| Answer Options | array |
| Answer Option | text |
| Field | Type |
|---|---|
| @odata type | text |
| Answer input type | text |
| Answer options | array |
| Created date time | date |
| Display name | text |
| ID | text |
| Last updated date time | date |
Create a Booking Service
ActionNew bookable service with duration, price and attendee limit.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Display NameRequired | text |
| Description | text |
| Language Tag | text |
| Maximum Attendees Count | number |
| Default Duration | text |
| Default Location | object |
| Display Name | text |
| Address | object |
| Default Price | number |
| Default Price Type | text |
| Additional Information | text |
| Notes | text |
| Is Anonymous Join Enabled | boolean |
| Is Customer Allowed to Manage Booking | boolean |
| Is Hidden From Customers | boolean |
| Is Location Online | boolean |
| SMS Notifications Enabled | boolean |
| Post Buffer | text |
| Pre Buffer | text |
| Web URL | url |
| Staff Member IDs | choice |
3other input fields
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Created date time | date |
| Custom questions | array |
| Default duration | text |
| Default location | object |
| @odata type | text |
| Default price | text |
| Default price type | text |
| Default reminders | array |
| Description | text |
| Display name | text |
| ID | text |
| Is anonymous join enabled | text |
| Is customer allowed to manage booking | text |
| Is hidden from customers | text |
| Is location online | text |
| Language tag | text |
| Last updated date time | date |
| Maximum attendees count | text |
| Notes | text |
6other output fields
Create a Booking Staff Member
ActionStaff profile holding role, working hours and time zone.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Display NameRequired | text |
Email AddressRequired | |
RoleRequired | text |
| Availability Is Affected By Personal Calendar | boolean |
| Is Email Notification Enabled | boolean |
| Time Zone | time |
| Use Business Hours | boolean |
| Working Hours | array |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Delete a Booking Appointment
ActionClears one appointment out of the booking schedule.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Delete a Booking Business
ActionRemoves one business from Microsoft Bookings by ID.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Delete a Booking Customer
ActionClears one saved customer record.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Delete a Booking Question
ActionRemoves one custom question and its answers.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Delete a Booking Service
ActionRemoves one bookable service.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Delete a Booking Staff Member
ActionRemoves one person from the staff list.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
Make an API Call
universalFree-form Microsoft Bookings REST API request.
| Field | Type |
|---|---|
URLRequired | text |
MethodRequired | choice |
| Headers | array |
| Header | object |
| Query String | array |
| Parameter | object |
| Body | text |
| Field | Type |
|---|---|
| Body | text |
| Headers | object |
| Status code | number |
Update a Booking Appointment
ActionMoves or edits an existing appointment.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Service ID | choice |
| Customer Email Address | |
| Customer Name | text |
Start DateTimeRequired | object |
DateTimeRequired | date |
| Time Zone | time |
End DateTimeRequired | object |
DateTimeRequired | date |
| Time Zone | time |
| Duration | text |
| Additional Information | text |
| Appointment Label | text |
| Anonymous Join Web URL | url |
| Customer Notes | text |
| Customer Phone | text |
| Customers | array |
| Customer Time Zone | time |
| Filled Attendees Count | number |
| Is Customer Allowed To Manage Booking | boolean |
| Is Location Online | boolean |
| Join Web URL | url |
| Maximum Attendees Count | number |
| Opt-Out Of Customer Email | boolean |
11other input fields
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Anonymous join web URL | text |
| Appointment label | text |
| Created date time | date |
| Customer email address | |
| Customer name | text |
| Customer notes | text |
| Customer phone | text |
| Customers | array |
| Customer time zone | text |
| Duration | text |
| End | object |
| @odata type | text |
| Filled attendees count | text |
| ID | text |
| Is customer allowed to manage booking | text |
| Is location online | text |
| Join web URL | url |
| Last updated date time | date |
| Maximum attendees count | text |
14other output fields
Update a Booking Business
ActionName, hours and contact details of a business.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Display Name | text |
| Business Type | text |
| Address | object |
| Street | text |
| City | text |
| State | text |
| Postal Code | text |
| Country Or Region | text |
| Booking Page Settings | object |
| Allow Anonymous Bookings | boolean |
| Is Published | boolean |
| Business Hours | array |
| Default Currency ISO | text |
| Language Tag | text |
| Phone | text |
| Public URL | url |
| Website URL | url |
| Scheduling Policy | object |
| Maximum Advance | number |
| Minimum Lead Time | number |
| Send Confirmations To Owner | boolean |
| Field | Type |
|---|---|
| @odata type | text |
| Address | object |
| @odata type | text |
| Booking page settings | object |
| @odata type | text |
| Business hours | array |
| Business type | text |
| Created date time | date |
| Default currency iso | text |
| Display name | text |
| ID | text |
| Is published | text |
| Language tag | text |
| Last updated date time | date |
| Phone | text |
| Public URL | url |
| Scheduling policy | object |
| @odata type | text |
| Web site URL | url |
Update a Booking Customer
ActionEdits the saved contact information.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Email Address | |
| Display Name | text |
| Addresses | array |
| Phones | array |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Update a Booking Question
ActionEdits the wording and answer type of a question.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Display Name | text |
| Answer Input Type | choice |
| Answer Options | array |
| Answer Option | text |
| Field | Type |
|---|---|
| @odata type | text |
| Answer input type | text |
| Answer options | array |
| Created date time | date |
| Display name | text |
| ID | text |
| Last updated date time | date |
Update a Booking Service
ActionEdits length, price and capacity of a service.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Display Name | text |
| Description | text |
| Language Tag | text |
| Maximum Attendees Count | number |
| Default Duration | text |
| Default Location | object |
| Display Name | text |
| Address | object |
| Default Price | number |
| Default Price Type | text |
| Additional Information | text |
| Notes | text |
| Is Anonymous Join Enabled | boolean |
| Is Customer Allowed to Manage Booking | boolean |
| Is Hidden From Customers | boolean |
| Is Location Online | boolean |
| SMS Notifications Enabled | boolean |
| Post Buffer | text |
| Pre Buffer | text |
| Web URL | url |
| Staff Member IDs | choice |
3other input fields
| Field | Type |
|---|---|
| @odata type | text |
| Additional information | text |
| Created date time | date |
| Custom questions | array |
| Default duration | text |
| Default location | object |
| @odata type | text |
| Default price | text |
| Default price type | text |
| Default reminders | array |
| Description | text |
| Display name | text |
| ID | text |
| Is anonymous join enabled | text |
| Is customer allowed to manage booking | text |
| Is hidden from customers | text |
| Is location online | text |
| Language tag | text |
| Last updated date time | date |
| Maximum attendees count | text |
| Notes | text |
6other output fields
Update a Booking Staff Member
ActionEdits role, hours and time zone of a staff member.
| Field | Type |
|---|---|
Booking Business IDRequired | choice |
| Display Name | text |
| Email Address | |
| Role | text |
| Availability Is Affected By Personal Calendar | boolean |
| Is Email Notification Enabled | boolean |
| Time Zone | time |
| Use Business Hours | boolean |
| Working Hours | array |
| Field | Type |
|---|---|
| @odata type | text |
| Addresses | array |
| Created date time | date |
| Display name | text |
| Email address | |
| ID | text |
| Last updated date time | date |
| Phones | array |
Templates
Look for Microsoft Bookings templates in the WEXTL template library.
Browse templates →Other scheduling integrations on WEXTL
Anny Customer API[2]Online booking and scheduling platform that lets customers book resources, services, and appointments in real time.
BookingKitOnline booking for tours and activities, with events, dates, orders, payments, products and vendors.
BookedSchedulerResource reservation and scheduling platform for booking rooms, equipment, and shared assets.
CalendlyScheduling automation for meetings and appointments.
BookeoOnline booking and appointment scheduling platform for tours, classes, and service businesses.
References
- WEXTL® Microsoft Bookings Source Code connector implementation.
- Our users use cases and automations.
- Official API Documentation for Microsoft Bookings.
- WEXTL® visual workflow builder data.
Last updated: Oct 12, 2026 17:58
How we write our apps documentation
How we compile these docs: sources, the role of AI, and how we verify.































