# HireHappy > HireHappy is an applicant tracking system. Its developer API (REST, JSON, API keys) gives your own systems an organization's jobs, candidates, applications, AI scorecards and interviews; its MCP server connects AI apps like Claude and ChatGPT as a member of the hiring team. - API base URL: https://api.hirehappy.io/v1 - Authentication: `Authorization: Bearer hh_sk_...`, a key made in the app under Settings → API keys - OpenAPI schema: https://hirehappy.io/docs/openapi.json - Everything below in one file: https://hirehappy.io/llms-full.txt ## Get started - [Quickstart](https://hirehappy.io/docs/quickstart.md): Make an API key, make your first call, and put a candidate forward for a job, in about five minutes. - [Authentication](https://hirehappy.io/docs/authentication.md): API keys, what each scope allows, expiry and revoking, and keeping keys safe. - [Conventions](https://hirehappy.io/docs/conventions.md): How every endpoint behaves - IDs, times, partial updates, filtering, files, the emails calls can send, and retrying. - [Pagination](https://hirehappy.io/docs/pagination.md): Page through jobs, candidates, applications and interviews with limit and offset. - [Errors](https://hirehappy.io/docs/errors.md): The one shape every error has, the types to branch on, and how to handle each. - [Versioning](https://hirehappy.io/docs/versioning.md): What can change within /v1 and what never will, and how you'll hear about changes. ## Guides - [Build a careers page](https://hirehappy.io/docs/careers-site.md): List your open jobs on your own site, in your own design, with every apply button going to HireHappy. - [Add candidates from anywhere](https://hirehappy.io/docs/add-candidates.md): Bring candidates in from referral forms, sourcing tools and events, with their resumes, put them forward for jobs and get them scored. - [Sync hires to your HR system](https://hirehappy.io/docs/sync-hires.md): Create new hires in your HRIS or payroll as soon as they're hired in HireHappy, and hire from your own systems. - [Show an interview calendar](https://hirehappy.io/docs/interview-calendar.md): Put the week's interviews on a dashboard, a meeting-room screen or a team channel, with who's interviewing whom and where. ## AI - [Connect AI apps (MCP)](https://hirehappy.io/docs/mcp.md): Add HireHappy to Claude, ChatGPT, Cursor or any MCP client, so it can work with your jobs and candidates as a member of your hiring team. - [Docs for AI coding tools](https://hirehappy.io/docs/ai-tools.md): Give Claude Code, Cursor, Copilot and other AI tools these docs as plain Markdown, and the OpenAPI schema for generating clients. ## Resources - [Changelog](https://hirehappy.io/docs/changelog.md): Every change to the HireHappy API and MCP server, newest first. ## API reference - [Organizations](https://hirehappy.io/docs/api/organizations.md): The organization the API key belongs to. Retrieve your organization. - [API keys](https://hirehappy.io/docs/api/api-keys.md): The API key itself: what it may do. Retrieve the api key. - [Jobs](https://hirehappy.io/docs/api/jobs.md): Your jobs: posting them on the job board, closing them, and their details. List jobs, create a job, retrieve a job, update a job. - [Job stages](https://hirehappy.io/docs/api/job-stages.md): A job's hiring pipeline, from the first stage to hired. List a job's stages. - [Candidates](https://hirehappy.io/docs/api/candidates.md): The people you're considering, one per person across all your jobs, with their resumes. List candidates, create a candidate, retrieve a candidate, update a candidate, delete a candidate, upload a candidate's resume. - [Notes](https://hirehappy.io/docs/api/notes.md): The hiring team's notes on candidates. List a candidate's notes, add a note. - [Applications](https://hirehappy.io/docs/api/applications.md): A candidate's candidacy for one job: its stage, status and AI score. List applications, create an application, retrieve an application, update an application. - [Scorecards](https://hirehappy.io/docs/api/scorecards.md): Applications scored by AI against their job's rubric, with the evidence. Retrieve an application's scorecard. - [Interviews](https://hirehappy.io/docs/api/interviews.md): Interviews, calls and assessments of applications. List interviews, list an application's interviews.