FeaturesAISecurityIntegrationsSelf-hostingDevelopersPricingUse casesWhy HarlyDocs
Live demoGet started

Build on top of your hiring.

A REST API, signed webhooks and a job widget for your website. Documented, open source and included in every install.

A REST API for your whole hiring process. Read and change jobs, candidates, applications, interviews and offers from your own code.

  • Every part of hiringJobs, stages, candidates, applications, interviews, offers, scorecards, tasks, talent pool and more.
  • Scoped keys36 scopes. Publishable keys for your website, secret keys for your servers.
  • Safe retriesSend an Idempotency-Key with any write and repeat it safely for 24 hours.
  • Cursor paginationUp to 100 results a page, with a cursor for the next one.
  • Clear limits1,000 requests every 10 minutes per key, with rate-limit headers on every response.
  • OpenAPI 3.1A live spec at /api/v1/openapi.json, generated from the same contracts the API uses.

Webhooks that arrive. Get an event when something changes, signed and retried until your server says yes.

  • Over 20 eventsApplications, candidates, interviews, tasks, signatures, jobs and evaluations.
  • Signed payloadsHMAC-SHA256 with a timestamp in the x-harly-signature-256 header.
  • Automatic retriesUp to six attempts over about 8.5 hours: after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours.
  • Delivery logsSee every attempt, replay a delivery or send a test event.
  • Inbound webhooksStart a Harly automation from another system with a signed request.

Your open roles, on your website. Add one script tag to list jobs and take applications on any page.

  • One snippetA small script with no iframe and no dependencies.
  • Filters and themesSearch, department filters, light or dark mode and your accent color.
  • Apply inlineCandidates apply without leaving your site. Bot protection included.
  • Public APIList open jobs and submit applications from your own front end, with CORS.

What the API covers. 69 operations, all under /api/v1.

Jobs7 operationsCreate, update, publish and close
Job stages6 operationsCreate, reorder and archive
Candidates11 operationsProfiles, notes, tags and files
Applications7 operationsCreate, move, reject, hire and bulk import
Interviews6 operationsSchedule, cancel and complete
Offers7 operationsCreate, send, record the decision and withdraw
Scorecards2 operationsRead and submit feedback
Tasks5 operationsCreate, update and complete
Talent pool4 operationsAdd and assign candidates
Activity1 operationThe event history of a workspace
Webhooks8 operationsEndpoints, tests, deliveries and replays
API keys4 operationsCreate, rotate and revoke

Built for AI agents, too. A built-in MCP server lets AI apps work with Harly on each person’s behalf.

Over 200 tools

Candidates, jobs, messages, interviews, offers, documents, tasks and reports.

OAuth 2.1 sign-in

No shared keys. Each person approves access, and tokens follow their role.

Works with your tools

Setup guides for Claude, ChatGPT, Claude Code, Cursor and VS Code.

See how it works

Questions.

Not yet. The API is described by an OpenAPI 3.1 spec, so you can generate a typed client in most languages.

Each key has scopes, and a key can’t have more access than the person who created it. Keys apply to the whole workspace rather than to a role’s jobs or departments, and they keep working until you revoke them.

On the docs site, generated from the spec. Every Harly install also serves its own reference at /docs/api.

Yes. Harly has a built-in MCP server, so tools like Claude, ChatGPT and Cursor can work with your hiring data after each person signs in.

Harly retries five more times over about 8.5 hours. After that the delivery is marked as failed, and you can replay it from the delivery log.

Hiring software, on your terms.

Open source. Self-hosted. Built for growing teams.