Edit

Share via

Custom domain support in Shared Bookings

  • Article

Microsoft allows organizations to own more than one domain. The default domain is onmicrosoft.com. You can read more about domains and how to create them at Add a domain to Microsoft 365.

You can specify which domain will be used from the domain list for Bookings using OWA mailbox policy. Once the default domain policy is configured and deployed, any new booking calendars created will have the configured domain in the SMTP address.

For example: Shared Booking pages can be created with a domain “contoso.com” instead of “contoso.onmicrosoft.com”

You can also configure a domain for specific users. When users with the custom OWA policy create a shared booking page, it will be created with the custom domain, and not the default domain.

To use these features, you'll need to run commands using Exchange Online PowerShell with Global admin access. For more information on running Exchange Online cmdlets, see Connect to Exchange Online PowerShell.

Note

This change will not impact shared booking pages that have already been created. Only new shared booking pages will be created using the configured domain.

Specify default domain for entire organization

You'll need to run the following commands using Exchange Online PowerShell.

Important

The steps below assume that no other Outlook Web App (OWA) mailbox policies have been created in your organization.

  1. Sign in to the Microsoft 365 admin center as a global admin.

  2. In the admin center, go to Settings > Domains to check current domains.

  3. Join into remote PowerShell command with the admin account and complete the steps, such as install module and import module. Learn more at Connect to Exchange Online PowerShell.

  4. Check the current default domain using the command below:

    Get-OwaMailboxPolicy -Identity OwaMailboxPolicy-Default | Fl BookingsMailboxDomain

  5. Change current default domain to new domain.

    Set-OwaMailboxPolicy -Identity OwaMailboxPolicy-Default -BookingsMailboxDomain "<newdomain>"

This would change the default policy of all users and allow them to create a shared booking page with the new domain.

Note

The OWA Mailbox policy can only be assigned by an admin account.

Configure custom domain for specific users

To configure a custom domain for a specific user, follow the steps below after joining into remote PowerShell.

  1. Create a new OWA mailbox policy.

    New-OwaMailboxPolicy -Name “<custom-policy-name>”

    For more information, see New-OwaMailboxPolicy.

  2. Configure the policy with a custom domain.

    Set-OwaMailboxPolicy -Identity “<custom-policy-name>” -BookingsMailboxDomain “<Custom-domain-name>"

  3. Set the new policy to specific users in the organization.

    Set-CASMailbox -Identity <User-email-address>-OwaMailboxPolicy “<custom-policy-name>”

    For more information, see Set-CASMailbox.

When users with the custom OWA policy create a shared booking page, it will be created with the custom domain, and not the default domain.