# HollyHR Developer Docs

> Public Preview API docs. Reads are on every plan; writes are on Standard and above. Use the OpenAPI schema for endpoint contracts and guide pages for authentication, scopes, requests, MCP, webhooks, provider-readiness context, and time-to-first-call smoke testing.

Every guide is also published as Markdown: add .md to its URL, for example https://developers.hollyhr.com/quickstart.md (the overview is https://developers.hollyhr.com/index.md). The hosted MCP endpoint is https://app.hollyhr.com/api/mcp.

## Start Here

- [Overview](https://developers.hollyhr.com/)
- [5-minute quickstart](https://developers.hollyhr.com/quickstart)
- [Sandbox and TTFC](https://developers.hollyhr.com/sandbox)
- [TypeScript SDK](https://developers.hollyhr.com/typescript-sdk)
- [Authentication](https://developers.hollyhr.com/authentication)

## Core API

- [API modules](https://developers.hollyhr.com/api-modules)
- [Requests](https://developers.hollyhr.com/requests)
- [Pagination examples](https://developers.hollyhr.com/pagination-examples)
- [Fields and metadata](https://developers.hollyhr.com/fields-and-metadata)
- [Environments and testing](https://developers.hollyhr.com/environments-testing)
- [Webhooks](https://developers.hollyhr.com/webhooks)
- [Provider readiness](https://developers.hollyhr.com/provider-readiness)
- [OpenAPI imports](https://developers.hollyhr.com/openapi-imports)

## AI and MCP

- [HollyHR MCP](https://developers.hollyhr.com/mcp)
- [AI connectors](https://developers.hollyhr.com/ai-connectors)
- [Reviewer demo guide](https://developers.hollyhr.com/reviewer-demo-handoff)
- [AI safety and privacy](https://developers.hollyhr.com/ai-safety-privacy)

## Integrations

- [Slack and Microsoft Teams](https://developers.hollyhr.com/collaboration-apps)
- [Zapier](https://developers.hollyhr.com/zapier)
- [Make](https://developers.hollyhr.com/make)
- [Xero Payroll UK](https://developers.hollyhr.com/xero-payroll)
- [Staffology private preview](https://developers.hollyhr.com/staffology-payroll)

## Recipes

- [Recipe index](https://developers.hollyhr.com/recipes)
- [GitHub Actions recipes](https://developers.hollyhr.com/github-actions-recipes)
- [MCP smoke test](https://developers.hollyhr.com/mcp-smoke)
- [Safe MCP leave booking](https://developers.hollyhr.com/safe-mcp-leave-booking)
- [People sync](https://developers.hollyhr.com/people-sync)
- [Expense and spend tools](https://developers.hollyhr.com/expense-spend-tools)
- [Test SDK from source](https://developers.hollyhr.com/sdk-before-npm)
- [Slack who's away](https://developers.hollyhr.com/slack-whos-away)
- [Google Sheets export](https://developers.hollyhr.com/google-sheets-export)
- [Receive webhooks in Node](https://developers.hollyhr.com/node-webhook-receiver)
- [Create person + webhook](https://developers.hollyhr.com/create-person-webhook)
- [Webhook + payroll references](https://developers.hollyhr.com/webhook-payroll-references)
- [Payroll readiness export](https://developers.hollyhr.com/reference/exports/payroll-readiness-export/guide)

## Resources

- [Changelog](https://developers.hollyhr.com/changelog)
- [Planned changes](https://developers.hollyhr.com/planned-changes)
- [Support and feedback](https://developers.hollyhr.com/support)

## API Reference

- [API reference](https://developers.hollyhr.com/reference)
- [OpenAPI schema](https://developers.hollyhr.com/openapi.v1.yaml)
- [Organisation guide](https://developers.hollyhr.com/reference/organisation/guide)
- [People guide](https://developers.hollyhr.com/reference/people/guide)
- [Employers guide](https://developers.hollyhr.com/reference/employers/guide)
- [Org Units guide](https://developers.hollyhr.com/reference/org-units/guide)
- [Working Patterns guide](https://developers.hollyhr.com/reference/working-patterns/guide)
- [Time Off guide](https://developers.hollyhr.com/reference/time-off/guide)
- [Documents guide](https://developers.hollyhr.com/reference/documents/guide)
- [Custom Fields guide](https://developers.hollyhr.com/reference/custom-fields/guide)
- [Reference Data guide](https://developers.hollyhr.com/reference/reference-data/guide)
- [Exports guide](https://developers.hollyhr.com/reference/exports/guide)
- [Payroll Readiness Export guide](https://developers.hollyhr.com/reference/exports/payroll-readiness-export/guide)
- [Webhook Management guide](https://developers.hollyhr.com/reference/webhooks/guide)