Obtain your HackerRank for Work API key from the account settings in your HackerRank for Work dashboard; the API base URL is https://www.hackerrank.com/x/api/v3
Identify the test ID for the assessment you want to send; retrieve it by calling GET /tests to list all tests in your account
To invite a candidate, send POST /tests/{testId}/invitations with a JSON body containing at minimum the candidate's email and, optionally, their name; this triggers an invitation email to the candidate
Poll GET /tests/{testId}/candidates or GET /invitations/{invitationId} to check the invitation and result status; states include pending, started, and completed
When the status is completed, retrieve the candidate's score and report via GET /tests/{testId}/candidates/{candidateId} or by accessing the invitation's result URL in the response
Handle pagination on list endpoints using the limit and offset query parameters
Known gotchas
The HackerRank for Work API is documented at hackerrank.com/work/apidocs and is distinct from the public HackerRank platform API; ensure you are using the /x/api/v3 base path for Work endpoints
Test IDs are environment-specific; a test created in one HackerRank for Work account cannot be referenced from another account's API key
Invitation emails are sent immediately upon the POST call; test with a sandbox or internal email address before running bulk invitations against real candidates
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp