# Microsoft Dynamics 365 Human Resources — HRIS API: overview

> Canonical URL: https://developers.apideck.com/apis/hris/microsoft-dynamics-hr/overview

Microsoft Dynamics 365 Human Resources helps organizations manage employee data, streamline HR processes, and create optimal employee experiences.
- Status: live
- Authentication: oauth2

- **supported resource categories:**   - **name:** People
  - **resources:** employees
  - **resources:** payroll-employees
  - **name:** Payroll
  - **resources:** payroll-fixed-compensation
  - **name:** Compensation
- **partnership required:** false
- **apideck credentials available:** true
- **authentication note:** Delegated sign-in through Microsoft Entra ID.
- **sandbox note:** Free 30-day Finance & Operations trial with demo data via email signup; a paid subscription also includes a sandbox environment next to production.
- **sandbox available:** true
- **environment notes:**   - **description:** The operations URL entered at connection time is both the API host and the sign-in audience, so it decides which environment a connection reaches; the Dataverse address (*.crm.dynamics.com) does not work in its place. For testing, use the free 30-day trial (hosts such as trial-na-xxxxxxxx.operations.dynamics.com) or the sandbox environment included with a paid subscription. Apideck's temporary shared test credentials are an alternative for early evaluation (request access via https://help.apideck.com/en/articles/7774658). Take care when testing against a production environment.
  - **environment:** Testing and production
- **apideck credentials note:** For testing: the Microsoft consent screen shows "Apideck" as the requesting application.
- **responsibility matrix:**   - **apideck:** Docs provided
  - **area:** Register a Microsoft Entra app with the Dynamics ERP permissions and grant admin consent
  - **customer:** ✓ (or use Apideck credentials)
  - **customer:** ✓
  - **area:** Add Client ID and Client Secret in the Apideck Dashboard
  - **area:** Enter the operations URL and authorize in Vault
  - **consumer:** ✓
  - **area:** Token refresh and credential storage
  - **apideck:** ✓
  - **apideck:** ✓
  - **area:** Maintain the connector and the unified HRIS API
- **important to know:** Standalone Human Resources environments are moving onto the Finance & Operations infrastructure, and one that has not moved yet has no operations URL to connect. Microsoft gives customers 12 months to migrate, counted from when its migration tooling becomes available.
- **webhooks:** Virtual webhooks - employee created, updated and terminated events, detected by polling
- **difficulty reason:** Own Microsoft Entra App Registration Required
- **consumer access level:** A Finance & Operations user whose security role grants Data Services access to the Workers and Employments data entities
- **external guides:**   - **source:** Microsoft Learn
  - **title:** Provision a Human Resources environment (free 30-day trial and environment counts)
  - **url:** https://learn.microsoft.com/en-us/dynamics365/human-resources/hr-admin-setup-provision-fo
  - **title:** Human Resources customer migration FAQ
  - **source:** Microsoft Learn
  - **url:** https://learn.microsoft.com/en-us/dynamics365/human-resources/customer-migration
  - **url:** https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/data-entities/priority-based-throttling
  - **source:** Microsoft Learn
  - **title:** Priority-based throttling for finance and operations
- **rate limits:** Resource-based service protection (version 10.0.19 and later) returns "Too many requests" when environment health is affected; no fixed quota is published.
- **account type required:** Dynamics 365 Human Resources environment on the Finance & Operations infrastructure (https://<org>.operations.dynamics.com)
- **difficulty:** moderate
- **sandbox url:** https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/fin-ops/get-started/before-you-buy

## Supported resources

- **name:** Employees
- **id:** employees
- **downstream id:** employees
- **downstream name:** Employees
- **status:** live
- **custom field support:** false

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/hris/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/hris/coverage)