# HollyHR People API

**Canonical:** https://apis.io/apis/hollyhr-com/hollyhr-com-people-api/  
**Provider:** HollyHR — https://apis.io/providers/hollyhr-com/  
**Base URL:** https://app.hollyhr.com  
**Documentation:** https://developers.hollyhr.com/reference

HollyHR People API is one of 14 APIs that [HollyHR](https://apis.io/providers/hollyhr-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include People. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The People API from HollyHR — 7 operation(s) for people.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/people` | List people |
| POST | `/people` | Create a person |
| GET | `/people/{personId}` | Fetch one person |
| PATCH | `/people/{personId}` | Update a person |
| GET | `/people/{personId}/personal` | Fetch one person's elevated personal profile |
| GET | `/people/{personId}/avatar` | Fetch one person's profile avatar URL |
| GET | `/people/{personId}/org-links` | Fetch a person's organisation links |
| GET | `/people/{personId}/custom-fields` | Fetch a person's custom-field values |
| PATCH | `/people/{personId}/custom-fields` | Update a person's custom-field values |
| GET | `/people/{personId}/time-off-balance` | Fetch a person's time-off balance explanation |
| GET | `/people/{personId}/time-off-balance/ledger` | List a person's leave-balance ledger history |
| POST | `/people/{personId}/time-off-balance/adjustments` | Create a leave-balance adjustment |
| POST | `/people/{personId}/end` | End a person |
| POST | `/people/{personId}/reactivate` | Reactivate a person |
| GET | `/people/{personId}/employment` | Get a person's employment details |
| PATCH | `/people/{personId}/employment` | Update a person's employment details |
| GET | `/people/{personId}/employment-history` | List a person's employment-history rows |
| POST | `/people/{personId}/employment-history` | Create a person's employment-history entry |
| GET | `/people/{personId}/employment-history/{historyId}` | Fetch one employment-history row |
| PATCH | `/people/{personId}/employment-history/{historyId}` | Correct an employment-history row |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hollyhr-com/openapi/hollyhr-com-people-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hollyhr-com/json-schema/hollyhr-com-get-webhooks-webhookid-health-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/hollyhr-com/json-schema/hollyhr-com-post-webhooks-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hollyhr-com/json-schema/hollyhr-com-post-people-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hollyhr-com/json-schema/hollyhr-com-patch-people-personid-employment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hollyhr-com/json-schema/hollyhr-com-post-people-personid-employment-history-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hollyhr-com/json-schema/hollyhr-com-post-api-mcp-request-schema.json

## Other HollyHR APIs (12)

- [HollyHR Org Units API](https://apis.io/apis/hollyhr-com/hollyhr-com-org-units-api/)
- [HollyHR Time Off API](https://apis.io/apis/hollyhr-com/hollyhr-com-time-off-api/)
- [HollyHR Webhooks API](https://apis.io/apis/hollyhr-com/hollyhr-com-webhooks-api/)
- [HollyHR Working Patterns API](https://apis.io/apis/hollyhr-com/hollyhr-com-working-patterns-api/)
- [HollyHR Custom Fields API](https://apis.io/apis/hollyhr-com/hollyhr-com-custom-fields-api/)
- [HollyHR Documents API](https://apis.io/apis/hollyhr-com/hollyhr-com-documents-api/)
- [HollyHR Employers API](https://apis.io/apis/hollyhr-com/hollyhr-com-employers-api/)
- [HollyHR Exports API](https://apis.io/apis/hollyhr-com/hollyhr-com-exports-api/)
- [HollyHR Integrations API](https://apis.io/apis/hollyhr-com/hollyhr-com-integrations-api/)
- [HollyHR Meta API](https://apis.io/apis/hollyhr-com/hollyhr-com-meta-api/)
- [HollyHR Organisation API](https://apis.io/apis/hollyhr-com/hollyhr-com-organisation-api/)
- [HollyHR Provider Mappings API](https://apis.io/apis/hollyhr-com/hollyhr-com-provider-mappings-api/)

## Tags

People

---

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