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

  1. From the Microsoft 365 admin center dashboard, go to Admin > Exchange.

  2. Go to organization > sharing.

  3. Under Organization Sharing, click New Add Icon.

  4. In new organization relationship, in the Relationship name box, type a friendly name for the organization relationship.

  5. 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.

  6. 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.

  1. 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,, and

  • Free/busy access is enabled.

  • and the subdomains get free/busy time, subject, and location information from your organization.

New-OrganizationRelationship -Name "Contoso" -DomainNames "","","" -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 | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails

For detailed syntax and parameter information, see Get-FederationInformation and New-OrganizationRelationship.

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:

New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "" -TargetApplicationUri ""

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


Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Online or Exchange Online Protection.