Bookings.Manage.All
Allows an app to read, write and manage bookings appointments, businesses, customers, services, and staff on behalf of the signed-in user.
Permission Details
Manage bookings information
Allows an app to read, write and manage bookings appointments, businesses, customers, services, and staff on behalf of the signed-in user.
6b22000a-1228-42ec-88db-b8c00399aecb
Manage bookings information
Allows an app to read, write and manage bookings appointments, businesses, customers, services, and staff on behalf of the signed-in user.
7f36b48e-542f-4d3b-9bcb-8406f0ab9fdb
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
address |
physicalAddress |
The street address of the business. The address property, together with phone and webSiteUrl, appear in the footer of a business scheduling page. The attribute type of physicalAddress is not supported in v1.0. Internally we map the addresses to the type others. |
bookingPageSettings |
bookingPageSettings |
Settings for the published booking page. |
businessHours |
bookingWorkHours collection |
The hours of operation for the business. |
businessType |
StringNullable |
The type of business. |
createdDateTime |
DateTimeOffsetNullable |
The date, time, and time zone when the booking business was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
defaultCurrencyIso |
StringNullable |
The code for the currency that the business operates in on Microsoft Bookings. |
displayName |
String |
The name of the business, which interfaces with customers. This name appears at the top of the business scheduling page. |
email |
StringNullable |
The email address for the business. |
id |
String |
A unique programmatic identifier for the business. Read-only. |
isPublished |
BooleanRead-onlyNullable |
The scheduling page has been made available to external customers. Use the publish and unpublish actions to set this property. Read-only. |
languageTag |
StringNullable |
The language of the self-service booking page. |
lastUpdatedDateTime |
DateTimeOffsetNullable |
The date, time, and time zone when the booking business was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
phone |
StringNullable |
The telephone number for the business. The phone property, together with address and webSiteUrl, appear in the footer of a business scheduling page. |
publicUrl |
StringRead-onlyNullable |
The URL for the scheduling page, which is set after you publish or unpublish the page. Read-only. |
schedulingPolicy |
bookingSchedulingPolicy |
Specifies how bookings can be created for this business. |
Showing 15 of 22 properties.
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"@odata.type": "#microsoft.graph.bookingBusiness",
"address": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"bookingPageSettings": {
"@odata.type": "microsoft.graph.bookingPageSettings"
},
"businessHours": [
{
"@odata.type": "microsoft.graph.bookingWorkHours"
}
],
"businessType": "String",
"createdDateTime": "String (timestamp)",
"defaultCurrencyIso": "String",
"displayName": "String",
"email": "String",
"id": "String (identifier)",
"isPublished": "Boolean",
"languageTag": "String",
"lastUpdatedDateTime": "String (timestamp)",
"phone": "String",
"publicUrl": "String",
"schedulingPolicy": {
"@odata.type": "microsoft.graph.bookingSchedulingPolicy"
},
"webSiteUrl": "String"
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
appointments |
bookingAppointment collection |
All the appointments of this business. Read-only. Nullable. |
calendarView |
bookingAppointment collection |
The set of appointments of this business in a specified date range. Read-only. Nullable. |
customers |
bookingCustomer collection |
All the customers of this business. Read-only. Nullable. |
customQuestions |
bookingCustomQuestion collection |
All the custom questions of this business. Read-only. Nullable. |
services |
bookingService collection |
All the services offered by this business. Read-only. Nullable. |
staffMembers |
bookingStaffMember collection |
All the staff members that provide services in this business. Read-only. Nullable. |
businessHours |
bookingWorkHours collection |
The hours of operation for the business. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Solutions.BookingBusinesses["{bookingBusiness-id}"].Publish.PostAsync();
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/solutions/bookingBusinesses/[email protected]/publish')
.post();
Import-Module Microsoft.Graph.Bookings
Publish-MgBookingBusiness -BookingBusinessId $bookingBusinessId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
await graph_client.solutions.booking_businesses.by_booking_business_id('bookingBusiness-id').publish.post()
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for Bookings.Manage.All
Grant Admin Consent
Application permissions always require admin consent.