Skip to content
emploreadocs

Emplorea for agents and developers

Emplorea is an HR-as-a-Service platform for growing teams in Australia, New Zealand and the United Kingdom. Everything a company admin can do in the web app, an agent or integration can do programmatically: manage the company, employees, leave and webhooks.

Four ways in

  • REST API - https://app.emplorea.com/api/v1 (OpenAPI spec at /openapi.json)
  • MCP server - https://app.emplorea.com/mcp for Claude, GPT and any MCP client
  • Webhooks - signed real-time event delivery for employee.* and leave.* events
  • CLI - npm install -g emplorea-cli, then emplorea --help

Authentication

Every surface uses the same API key, created by a company admin in Settings, then Integrations. Keys are scoped (read, write, admin, webhooks), rate limited to 100 requests a minute, and shown exactly once at creation. Send the key as a Bearer token:

curl https://app.emplorea.com/api/v1/company \
  -H "Authorization: Bearer emp_live_your_key_here"

Conventions

  • Money is always integer cents - 9200000 means $92,000.
  • Dates are ISO YYYY-MM-DD; timestamps are ISO 8601 UTC.
  • Errors always look like {"error": {"code", "message", "field?"}}.
  • List endpoints paginate with ?page and ?limit and return a meta object.
  • Every response carries X-RateLimit-Limit / -Remaining / -Reset headers.
  • Nothing is ever hard-deleted - terminations and cancellations are soft deletes kept for compliance.

Quick start

The five-minute path: create a key, read the company, list employees, request leave. See the Quickstart page for the full worked example.