# Drata HRIS User Identities API

**Canonical:** https://apis.io/apis/drata/drata-hris-user-identities-api/  
**Provider:** Drata — https://apis.io/providers/drata/  
**Base URL:** https://public-api.drata.com/public/v2  
**Documentation:** https://developers.drata.com/openapi/reference/v2/overview/

Drata HRIS User Identities API is one of 52 APIs that [Drata](https://apis.io/providers/drata/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include HRIS User Identities. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

HR user identity records for a Custom HRIS connection. Use the batch upsert endpoint to submit employee records keyed by your own `identityId`, then use the update endpoint to reflect employment changes (e.g. set `separatedAt` when an employee leaves). Deleting a record is intended for data submitted in error, not for offboarding. Changes are not applied immediately — they are incorporated the next time identity sync runs, which happens nightly by default. A sync can also be triggered manually from the Personnel page.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/custom-connections/{connectionId}/hris-user-identities` | List HRIS User Identities 🧪 |
| POST | `/custom-connections/{connectionId}/hris-user-identities` | Create or Update HRIS User Identities 🧪 |
| GET | `/custom-connections/{connectionId}/hris-user-identities/{userIdentityId}` | Get HRIS User Identity 🧪 |
| DELETE | `/custom-connections/{connectionId}/hris-user-identities/{userIdentityId}` | Delete HRIS User Identity 🧪 |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/drata/refs/heads/main/openapi/drata-hris-user-identities-api-openapi.yml
- **Documentation** — https://developers.drata.com/openapi/reference/v2/overview/
- **APIReference** — https://developers.drata.com/openapi/reference/v2/overview/
- **GettingStarted** — https://developers.drata.com/developer-portal/v2/recipes/create-an-api-key/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/drata/refs/heads/main/authentication/drata-authentication.yml
- **Documentation** — https://developers.drata.com/openapi/reference/v2/tag/Custom-Connections/
- **GettingStarted** — https://developers.drata.com/developer-portal/v2/recipes/custom-connections/
- **Documentation** — https://docs.safebase.io/reference/getaccounts
- **APIReference** — https://docs.safebase.io/reference/getaccounts

## Other Drata APIs (12)

- [Drata MCP Server](https://apis.io/apis/drata/mcp/)
- [Drata Account Members API](https://apis.io/apis/drata/drata-account-members-api/)
- [Drata Accounts API](https://apis.io/apis/drata/drata-accounts-api/)
- [Drata Assets API](https://apis.io/apis/drata/drata-assets-api/)
- [Drata Audit Requests API](https://apis.io/apis/drata/drata-audit-requests-api/)
- [Drata Audits API](https://apis.io/apis/drata/drata-audits-api/)
- [Drata Background Checks API](https://apis.io/apis/drata/drata-background-checks-api/)
- [Drata Company API](https://apis.io/apis/drata/drata-company-api/)
- [Drata Control Library API](https://apis.io/apis/drata/drata-control-library-api/)
- [Drata Control Notes API](https://apis.io/apis/drata/drata-control-notes-api/)
- [Drata Control Owners API](https://apis.io/apis/drata/drata-control-owners-api/)
- [Drata Controls API](https://apis.io/apis/drata/drata-controls-api/)

## Tags

HRIS User Identities

---

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