Create an organization relationship in Exchange Online
Set up an organization relationship to share calendar information with an external business partner. Microsoft 365 and Office 365 admins can set up an organization relationship with another Microsoft 365 or Office 365 organization or with an Exchange on-premises organization.
What do you need to know before you begin?
Estimated time to complete: 15 minutes.
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the Permissions in Exchange Online topic.
If you want to share calendars with an on-premises Exchange organization, the on-premises Exchange administrator has to set up an authentication relationship with the cloud (also known as "federation") and must meet minimum software requirements.
Use the Exchange admin center to create an organization relationship
From the Microsoft 365 admin center dashboard, go to Admin > Exchange.
Go to organization > sharing.
Under Organization Sharing, click New .
In new organization relationship, in the Relationship name box, type a friendly name for the organization relationship.
In the Domains to share with box, type the domain for the external Microsoft 365, Office 365, or Exchange on-premises organization you want to let see your calendars. If you need to add more than one domain, you can do it after you create the organization relationship by editing it.
Select the Enable calendar free/busy information sharing check box to turn on calendar sharing with the domains you listed. Set the sharing level for calendar free/busy information and set which users can share calendar free/busy information.
To set the free/busy access level, select one of the following:
Calendar free/busy information with time only
Calendar free/busy with time, subject, and location
To set which users will share calendar free/busy information, select one of the following:
Everyone in your organization
A specified security group
Click browse to pick the security group from a list, then click ok.
- Click save to create the organization relationship.
Cross-tenant configurations do not support personal contacts for free/busy lookup. Contacts must be included in the global address list for free/busy lookup to work.
Use Exchange Online PowerShell to create an organization relationship
This example creates an organization relationship with Contoso, Ltd with the following conditions:
An organization relationship is set up with contoso.com, northamerica.contoso.com, and europe.contoso.com.
Free/busy access is enabled.
Contoso.com and the subdomains get free/busy time, subject, and location information from your organization.
New-OrganizationRelationship -Name "Contoso" -DomainNames "contoso.com","northamerica.contoso.com","europe.contoso.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails
If you're not sure which domains Contoso has set up for cloud-based authentication, you can run this command to automatically find the configuration information. The Get-FederationInformation cmdlet is used to find the right information, which is then passed to the New-OrganizationRelationship cmdlet.
Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails
If you're setting up an organization relationship with an on-premises Exchange organization, you may want to provide the connection settings. This example creates an organization relationship with Fourth Coffee and specifies the connection settings to use. The following conditions apply:
The organization relationship is established with the domain fourthcoffee.com.
The Exchange Web Services application URL is mail.fourthcoffee.com.
The Autodiscover URL is https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity.
Free/busy access is enabled.
Fourth Coffee sees free/busy information with the time.
New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"
For detailed syntax and parameter information, see New-OrganizationRelationship.
How do you know this worked?
The successful completion of the New organization relationship wizard indicates that the organization relationship was created.
You can also run the following command to verify the organization relationship information:
Get-OrganizationRelationship | format-list