# Microsoft Entra ID (formerly Azure AD) Service Principals.synchronization API

**Canonical:** https://apis.io/apis/azure-ad/azure-ad-serviceprincipals-synchronization-api/  
**Provider:** Microsoft Entra ID (formerly Azure AD) — https://apis.io/providers/azure-ad/  
**Base URL:** https://login.microsoftonline.com  
**Documentation:** https://learn.microsoft.com/en-us/azure/active-directory-b2c/

Microsoft Entra ID (formerly Azure AD) Service Principals.synchronization API is one of 186 APIs that [Microsoft Entra ID (formerly Azure AD)](https://apis.io/providers/azure-ad/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a changelog.

The servicePrincipals.synchronization API from Microsoft Entra ID (formerly Azure AD) — 34 operation(s) for serviceprincipals.synchronization.

## Operations (56)

| Method | Path | Summary |
|---|---|---|
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization` | Get synchronization from servicePrincipals |
| PUT | `/servicePrincipals/{servicePrincipal-id}/synchronization` | Update the navigation property synchronization in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization` | Delete navigation property synchronization for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs` | List synchronization jobs |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs` | Create synchronizationJob |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}` | Get synchronizationJob |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}` | Update the navigation property jobs in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}` | Delete synchronizationJob |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload` | Get bulkUpload from servicePrincipals |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload` | Update the navigation property bulkUpload in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload` | Delete navigation property bulkUpload for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload/$value` | Get media content for the navigation property bulkUpload from servicePrincipals |
| PUT | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload/$value` | Update media content for the navigation property bulkUpload in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload/$value` | Delete media content for the navigation property bulkUpload in servicePrincipals |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/microsoft.graph.pause` | Invoke action pause |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/microsoft.graph.provisionOnDemand` | Invoke action provisionOnDemand |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/microsoft.graph.restart` | Invoke action restart |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/microsoft.graph.start` | Invoke action start |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/microsoft.graph.validateCredentials` | Invoke action validateCredentials |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema` | Get synchronizationSchema |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema` | Update synchronizationSchema |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema` | Delete navigation property schema for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories` | Get directories from servicePrincipals |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories` | Create new navigation property to directories for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}` | Get directories from servicePrincipals |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}` | Update the navigation property directories in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}` | Delete navigation property directories for servicePrincipals |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}/microsoft.graph.discover` | Invoke action discover |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/$count` | Get the number of the resource |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/microsoft.graph.filterOperators()` | Invoke function filterOperators |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/microsoft.graph.functions()` | Invoke function functions |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/microsoft.graph.parseExpression` | Invoke action parseExpression |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/$count` | Get the number of the resource |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/microsoft.graph.validateCredentials` | Invoke action validateCredentials |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/microsoft.graph.acquireAccessToken` | Invoke action acquireAccessToken |
| PUT | `/servicePrincipals/{servicePrincipal-id}/synchronization/secrets` | Add synchronization secrets |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/secrets/$count` | Get the number of the resource |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates` | List existing synchronization templates |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates` | Create new navigation property to templates for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}` | Get templates from servicePrincipals |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}` | Update the navigation property templates in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}` | Delete navigation property templates for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema` | Get schema from servicePrincipals |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema` | Update the navigation property schema in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema` | Delete navigation property schema for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories` | Get directories from servicePrincipals |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories` | Create new navigation property to directories for servicePrincipals |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}` | Get directories from servicePrincipals |
| PATCH | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}` | Update the navigation property directories in servicePrincipals |
| DELETE | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}` | Delete navigation property directories for servicePrincipals |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}/microsoft.graph.discover` | Invoke action discover |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/$count` | Get the number of the resource |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/microsoft.graph.filterOperators()` | Invoke function filterOperators |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/microsoft.graph.functions()` | Invoke function functions |
| POST | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/microsoft.graph.parseExpression` | Invoke action parseExpression |
| GET | `/servicePrincipals/{servicePrincipal-id}/synchronization/templates/$count` | Get the number of the resource |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-serviceprincipals-synchronization-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/api/overview
- **Authentication** — https://learn.microsoft.com/en-us/graph/auth/
- **SDKs** — https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
- **ChangeLog** — https://developer.microsoft.com/en-us/graph/changelog
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/change-notifications-overview

## Other Microsoft Entra ID (formerly Azure AD) APIs (12)

- [Azure AD B2C API](https://apis.io/apis/azure-ad/azure-ad-b2c-api/)
- [Microsoft Entra ID (formerly Azure AD) Admin.people Admin Settings API](https://apis.io/apis/azure-ad/azure-ad-admin-peopleadminsettings-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreement-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement Acceptance API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementacceptance-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement File API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementfile-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement File Localization API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementfilelocalization-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications API](https://apis.io/apis/azure-ad/azure-ad-applications-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application.Actions API](https://apis.io/apis/azure-ad/azure-ad-applications-application-actions-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application API](https://apis.io/apis/azure-ad/azure-ad-applications-application-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application.Functions API](https://apis.io/apis/azure-ad/azure-ad-applications-application-functions-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.app Management Policy API](https://apis.io/apis/azure-ad/azure-ad-applications-appmanagementpolicy-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.directory Object API](https://apis.io/apis/azure-ad/azure-ad-applications-directoryobject-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/azure-ad/azure-ad-serviceprincipals-synchronization-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/azure-ad/.
