Skip to docs navigation

Microsoft Bookings integration guide

Verified

How 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].

Open Microsoft Bookings on WEXTL →
  • Microsoft Bookings
  • WEXTL
  • Anny Customer API
  • BookingKit
  • BookedScheduler
  • Calendly
  • Bookeo
  • Anny Admin API
  • Boulevard
  • Acuity Scheduling
  • Avirato
  • AgendaPro
  • BookingPress
  • Amenitiz
  • Bookwhen
  • Booknetic
  • Betterez
  • Appointment Reminder
  • Calenso
  • Appointedd
  • AddEvent
  • BookingLayer
  • Agendize
  • Bookster
  • AxisRooms
  • Checkfront
  • Accelevents
  • Booxi
  • Check Cherry
  • Amelia
  • Cal.com
  • Calendesk
Credential type option 1

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.com and 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.All
  • Bookings.ReadWrite.All
  • Bookings.Manage.All
  • BookingsAppointment.ReadWrite.All
  • offline_access
  • User.Read
Credential type option 2

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.All
  • Bookings.ReadWrite.All
  • Bookings.Manage.All
  • BookingsAppointment.ReadWrite.All
  1. Log in to your WEXTL account, add the Microsoft Bookings node module to your workflow, and click Create new credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your Microsoft Bookings account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →
New Microsoft Bookings credential form open next to the Microsoft Bookings node in the WEXTL workflow builder
Video slide demonstrates how to integrate Microsoft Bookings in the WEXTL visual workflow builder.[4]

Watch Booking Appointments

TriggerScheduled check that emits newly created appointments.
Output fields[3]
FieldType
@odata typetext
Additional informationtext
Anonymous join web URLtext
Appointment labeltext
Created date timedate
Customer email addressemail
Customer nametext
Customer notestext
Customer phonetext
Customersarray
Customer time zonetext
Durationtext
Endobject
@odata typetext
Filled attendees counttext
IDtext
Is customer allowed to manage bookingtext
Is location onlinetext
Join web URLurl
Last updated date timedate
Maximum attendees counttext

14other output fields

Watch Booking Businesses

TriggerScheduled check for fresh booking businesses.
Output fields[3]
FieldType
@odata typetext
Addressobject
@odata typetext
Booking page settingsobject
@odata typetext
Business hoursarray
Business typetext
Created date timedate
Default currency isotext
Display nametext
Emailemail
IDtext
Is publishedtext
Language tagtext
Last updated date timedate
Phonetext
Public URLurl
Scheduling policyobject
@odata typetext
Web site URLurl

Watch Booking Customers

TriggerPolls for freshly saved customers.
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Watch Booking Questions

TriggerPolls the booking form for fresh questions.
Output fields[3]
FieldType
@odata typetext
Answer input typetext
Answer optionsarray
Created date timedate
Display nametext
IDtext
Last updated date timedate

Watch Booking Services

TriggerPolls for services added to the business.
Output fields[3]
FieldType
@odata typetext
Additional informationtext
Created date timedate
Custom questionsarray
Default durationtext
Default locationobject
@odata typetext
Default pricetext
Default price typetext
Default remindersarray
Descriptiontext
Display nametext
IDtext
Is anonymous join enabledtext
Is customer allowed to manage bookingtext
Is hidden from customerstext
Is location onlinetext
Language tagtext
Last updated date timedate
Maximum attendees counttext
Notestext

6other output fields

Watch Booking Staff Members

TriggerPolls for people newly added to the team.
Output fields[3]
FieldType
@odata typetext
Availability is affected by personal calendartext
Created date timedate
Display nametext
Email addressemail
IDtext
Is email notification enabledtext
Last updated date timedate
Roletext
Time zonetime
Use business hourstext
Working hoursarray

List Booking Appointments

SearchAppointments with customer and timing details.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Limitnumber
Output fields[3]
FieldType
@odata typetext
Additional informationtext
Anonymous join web URLtext
Appointment labeltext
Created date timedate
Customer email addressemail
Customer nametext
Customer notestext
Customer phonetext
Customersarray
Customer time zonetext
Durationtext
Endobject
@odata typetext
Filled attendees counttext
IDtext
Is customer allowed to manage bookingtext
Is location onlinetext
Join web URLurl
Last updated date timedate
Maximum attendees counttext

14other output fields

List Booking Businesses

SearchBooking businesses you can reach in Microsoft Bookings.
Input fields[3]
FieldType
Search Querytext
Limitnumber
Output fields[3]
FieldType
@odata typetext
Addressobject
@odata typetext
Booking page settingsobject
@odata typetext
Business hoursarray
Business typetext
Created date timedate
Default currency isotext
Display nametext
Emailemail
IDtext
Is publishedtext
Language tagtext
Last updated date timedate
Phonetext
Public URLurl
Scheduling policyobject
@odata typetext
Web site URLurl

List Booking Customers

SearchSaved customers and their contact details.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Limitnumber
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

List Booking Questions

SearchCustom questions defined for a booking business.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Limitnumber
Output fields[3]
FieldType
@odata typetext
Answer input typetext
Answer optionsarray
Created date timedate
Display nametext
IDtext
Last updated date timedate

List Booking Services

SearchServices offered by a booking business.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Limitnumber
Output fields[3]
FieldType
@odata typetext
Additional informationtext
Created date timedate
Custom questionsarray
Default durationtext
Default locationobject
@odata typetext
Default pricetext
Default price typetext
Default remindersarray
Descriptiontext
Display nametext
IDtext
Is anonymous join enabledtext
Is customer allowed to manage bookingtext
Is hidden from customerstext
Is location onlinetext
Language tagtext
Last updated date timedate
Maximum attendees counttext
Notestext

6other output fields

List Booking Staff Members

SearchStaff people with their assigned roles.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Limitnumber
Output fields[3]
FieldType
@odata typetext
Availability is affected by personal calendartext
Created date timedate
Display nametext
Email addressemail
IDtext
Is email notification enabledtext
Last updated date timedate
Roletext
Time zonetime
Use business hourstext
Working hoursarray

Retrieve a Booking Appointment

ActionDetails of one scheduled appointment.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Output fields[3]
FieldType
@odata typetext
Additional informationtext
Anonymous join web URLtext
Appointment labeltext
Created date timedate
Customer email addressemail
Customer nametext
Customer notestext
Customer phonetext
Customersarray
Customer time zonetext
Durationtext
Endobject
@odata typetext
Filled attendees counttext
IDtext
Is customer allowed to manage bookingtext
Is location onlinetext
Join web URLurl
Last updated date timedate
Maximum attendees counttext

14other output fields

Retrieve a Booking Business

ActionSettings and contact details of a single business.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Output fields[3]
FieldType
@odata typetext
Addressobject
@odata typetext
Booking page settingsobject
@odata typetext
Business hoursarray
Business typetext
Created date timedate
Default currency isotext
Display nametext
Emailemail
IDtext
Is publishedtext
Language tagtext
Last updated date timedate
Phonetext
Public URLurl
Scheduling policyobject
@odata typetext
Web site URLurl

Retrieve a Booking Customer

ActionContact record held for one customer.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Retrieve a Booking Question

ActionOne custom question from a booking business.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Output fields[3]
FieldType
@odata typetext
Answer input typetext
Answer optionsarray
Created date timedate
Display nametext
IDtext
Last updated date timedate

Retrieve a Booking Service

ActionDetails of a single bookable service.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Output fields[3]
FieldType
@odata typetext
Additional informationtext
Created date timedate
Custom questionsarray
Default durationtext
Default locationobject
@odata typetext
Default pricetext
Default price typetext
Default remindersarray
Descriptiontext
Display nametext
IDtext
Is anonymous join enabledtext
Is customer allowed to manage bookingtext
Is hidden from customerstext
Is location onlinetext
Language tagtext
Last updated date timedate
Maximum attendees counttext
Notestext

6other output fields

Retrieve a Booking Staff Member

ActionProfile details for a single staff person.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Cancel a Booking Appointment

ActionMarks a scheduled appointment as cancelled.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Create a Booking Appointment

ActionNew appointment for a service, with start, end and customer details.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Service IDRequired
choice
Customer Email Addressemail
Customer Nametext
Start DateTimeRequired
object
DateTimeRequired
date
Time Zonetime
End DateTimeRequired
object
DateTimeRequired
date
Time Zonetime
Durationtext
Additional Informationtext
Appointment Labeltext
Anonymous Join Web URLurl
Customer Notestext
Customer Phonetext
Customersarray
Customer Time Zonetime
Filled Attendees Countnumber
Is Customer Allowed To Manage Bookingboolean
Is Location Onlineboolean
Join Web URLurl
Maximum Attendees Countnumber
Opt-Out Of Customer Emailboolean

11other input fields

Output fields[3]
FieldType
@odata typetext
Additional informationtext
Anonymous join web URLtext
Appointment labeltext
Created date timedate
Customer email addressemail
Customer nametext
Customer notestext
Customer phonetext
Customersarray
Customer time zonetext
Durationtext
Endobject
@odata typetext
Filled attendees counttext
IDtext
Is customer allowed to manage bookingtext
Is location onlinetext
Join web URLurl
Last updated date timedate
Maximum attendees counttext

14other output fields

Create a Booking Business

ActionNew business with hours, scheduling policy and contact details.
Input fields[3]
FieldType
Display NameRequired
text
Business TypeRequired
text
Emailemail
Addressobject
Streettext
Citytext
Statetext
Postal Codetext
Country Or Regiontext
Booking Page Settingsobject
Allow Anonymous Bookingsboolean
Is Publishedboolean
Business Hoursarray
Default Currency ISOtext
Language Tagtext
Phonetext
Public URLurl
Website URLurl
Scheduling Policyobject
Maximum Advancenumber
Minimum Lead Timenumber
Send Confirmations To Ownerboolean
Output fields[3]
FieldType
@odata typetext
Addressobject
@odata typetext
Booking page settingsobject
@odata typetext
Business hoursarray
Business typetext
Created date timedate
Default currency isotext
Display nametext
Emailemail
IDtext
Is publishedtext
Language tagtext
Last updated date timedate
Phonetext
Public URLurl
Scheduling policyobject
@odata typetext
Web site URLurl

Create a Booking Customer

ActionNew customer record with email, name, addresses and phones.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Email AddressRequired
email
Display Nametext
Addressesarray
Phonesarray
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Create a Booking Question

ActionNew question with an answer type and options.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display NameRequired
text
Answer Input Typechoice
Answer Optionsarray
Answer Optiontext
Output fields[3]
FieldType
@odata typetext
Answer input typetext
Answer optionsarray
Created date timedate
Display nametext
IDtext
Last updated date timedate

Create a Booking Service

ActionNew bookable service with duration, price and attendee limit.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display NameRequired
text
Descriptiontext
Language Tagtext
Maximum Attendees Countnumber
Default Durationtext
Default Locationobject
Display Nametext
Addressobject
Default Pricenumber
Default Price Typetext
Additional Informationtext
Notestext
Is Anonymous Join Enabledboolean
Is Customer Allowed to Manage Bookingboolean
Is Hidden From Customersboolean
Is Location Onlineboolean
SMS Notifications Enabledboolean
Post Buffertext
Pre Buffertext
Web URLurl
Staff Member IDschoice

3other input fields

Output fields[3]
FieldType
@odata typetext
Additional informationtext
Created date timedate
Custom questionsarray
Default durationtext
Default locationobject
@odata typetext
Default pricetext
Default price typetext
Default remindersarray
Descriptiontext
Display nametext
IDtext
Is anonymous join enabledtext
Is customer allowed to manage bookingtext
Is hidden from customerstext
Is location onlinetext
Language tagtext
Last updated date timedate
Maximum attendees counttext
Notestext

6other output fields

Create a Booking Staff Member

ActionStaff profile holding role, working hours and time zone.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display NameRequired
text
Email AddressRequired
email
RoleRequired
text
Availability Is Affected By Personal Calendarboolean
Is Email Notification Enabledboolean
Time Zonetime
Use Business Hoursboolean
Working Hoursarray
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Delete a Booking Appointment

ActionClears one appointment out of the booking schedule.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Delete a Booking Business

ActionRemoves one business from Microsoft Bookings by ID.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Delete a Booking Customer

ActionClears one saved customer record.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Delete a Booking Question

ActionRemoves one custom question and its answers.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Delete a Booking Service

ActionRemoves one bookable service.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Delete a Booking Staff Member

ActionRemoves one person from the staff list.
Input fields[3]
FieldType
Booking Business IDRequired
choice

Make an API Call

universalFree-form Microsoft Bookings REST API request.
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Status codenumber

Update a Booking Appointment

ActionMoves or edits an existing appointment.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Service IDchoice
Customer Email Addressemail
Customer Nametext
Start DateTimeRequired
object
DateTimeRequired
date
Time Zonetime
End DateTimeRequired
object
DateTimeRequired
date
Time Zonetime
Durationtext
Additional Informationtext
Appointment Labeltext
Anonymous Join Web URLurl
Customer Notestext
Customer Phonetext
Customersarray
Customer Time Zonetime
Filled Attendees Countnumber
Is Customer Allowed To Manage Bookingboolean
Is Location Onlineboolean
Join Web URLurl
Maximum Attendees Countnumber
Opt-Out Of Customer Emailboolean

11other input fields

Output fields[3]
FieldType
@odata typetext
Additional informationtext
Anonymous join web URLtext
Appointment labeltext
Created date timedate
Customer email addressemail
Customer nametext
Customer notestext
Customer phonetext
Customersarray
Customer time zonetext
Durationtext
Endobject
@odata typetext
Filled attendees counttext
IDtext
Is customer allowed to manage bookingtext
Is location onlinetext
Join web URLurl
Last updated date timedate
Maximum attendees counttext

14other output fields

Update a Booking Business

ActionName, hours and contact details of a business.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display Nametext
Business Typetext
Emailemail
Addressobject
Streettext
Citytext
Statetext
Postal Codetext
Country Or Regiontext
Booking Page Settingsobject
Allow Anonymous Bookingsboolean
Is Publishedboolean
Business Hoursarray
Default Currency ISOtext
Language Tagtext
Phonetext
Public URLurl
Website URLurl
Scheduling Policyobject
Maximum Advancenumber
Minimum Lead Timenumber
Send Confirmations To Ownerboolean
Output fields[3]
FieldType
@odata typetext
Addressobject
@odata typetext
Booking page settingsobject
@odata typetext
Business hoursarray
Business typetext
Created date timedate
Default currency isotext
Display nametext
Emailemail
IDtext
Is publishedtext
Language tagtext
Last updated date timedate
Phonetext
Public URLurl
Scheduling policyobject
@odata typetext
Web site URLurl

Update a Booking Customer

ActionEdits the saved contact information.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Email Addressemail
Display Nametext
Addressesarray
Phonesarray
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Update a Booking Question

ActionEdits the wording and answer type of a question.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display Nametext
Answer Input Typechoice
Answer Optionsarray
Answer Optiontext
Output fields[3]
FieldType
@odata typetext
Answer input typetext
Answer optionsarray
Created date timedate
Display nametext
IDtext
Last updated date timedate

Update a Booking Service

ActionEdits length, price and capacity of a service.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display Nametext
Descriptiontext
Language Tagtext
Maximum Attendees Countnumber
Default Durationtext
Default Locationobject
Display Nametext
Addressobject
Default Pricenumber
Default Price Typetext
Additional Informationtext
Notestext
Is Anonymous Join Enabledboolean
Is Customer Allowed to Manage Bookingboolean
Is Hidden From Customersboolean
Is Location Onlineboolean
SMS Notifications Enabledboolean
Post Buffertext
Pre Buffertext
Web URLurl
Staff Member IDschoice

3other input fields

Output fields[3]
FieldType
@odata typetext
Additional informationtext
Created date timedate
Custom questionsarray
Default durationtext
Default locationobject
@odata typetext
Default pricetext
Default price typetext
Default remindersarray
Descriptiontext
Display nametext
IDtext
Is anonymous join enabledtext
Is customer allowed to manage bookingtext
Is hidden from customerstext
Is location onlinetext
Language tagtext
Last updated date timedate
Maximum attendees counttext
Notestext

6other output fields

Update a Booking Staff Member

ActionEdits role, hours and time zone of a staff member.
Input fields[3]
FieldType
Booking Business IDRequired
choice
Display Nametext
Email Addressemail
Roletext
Availability Is Affected By Personal Calendarboolean
Is Email Notification Enabledboolean
Time Zonetime
Use Business Hoursboolean
Working Hoursarray
Output fields[3]
FieldType
@odata typetext
Addressesarray
Created date timedate
Display nametext
Email addressemail
IDtext
Last updated date timedate
Phonesarray

Look for Microsoft Bookings templates in the WEXTL template library.

Browse templates →
  1. WEXTL® Microsoft Bookings Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for Microsoft Bookings.
  4. 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.