title	Create identitySynchronization
description	Create a cross-tenant user and optionally group synchronization policy for a partner-specific configuration.
author	rolyon
ms.localizationpriority	medium
ms.subservice	entra-sign-in
doc_type	apiPageType
ms.date	10/21/2024

Create identitySynchronization

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Create a cross-tenant user and optionally group synchronization policy for a partner-specific configuration.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

[!INCLUDE rbac-xtap-apis-write]

HTTP request

PUT /policies/crossTenantAccessPolicy/partners/{id}/identitySynchronization

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json. Required.

Request body

In the request body, supply a JSON representation of the crossTenantIdentitySyncPolicyPartner object.

You can specify the following properties when you create a crossTenantIdentitySyncPolicyPartner.

Property	Type	Description
displayName	String	Display name for the cross-tenant user and group synchronization policy. Use the name of the partner Microsoft Entra tenant to easily identify the policy. Optional.
groupSyncInbound	crossTenantGroupSyncInbound	Determines whether groups are synchronized from the partner tenant.
userSyncInbound	crossTenantUserSyncInbound	Determines whether users are synchronized from the partner tenant.

Response

If successful, this method returns a 204 No Content response code.

Examples

Request

The following example shows a request.

HTTP

PUT https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1/identitySynchronization
Content-Type: application/json

{
  "displayName": "Fabrikam",
  "groupSyncInbound": {
    "isSyncAllowed": true
  },
  "userSyncInbound": {
    "isSyncAllowed": true
  }
}