Generate a personal access token in the HackerRank for Work dashboard under API settings; store it as YOUR_HR_TOKEN.
Confirm the target test is in a published state — only published tests accept invitations via API.
POST to the invitation endpoint with the candidate email, test ID, and any custom fields to collect before the test starts; capture the returned invitation ID.
Respect the platform-recommended rate limit of no more than 10 API requests per second when sending bulk invitations.
Poll the sessions or results endpoint using the invitation or session ID to retrieve score, percentile, and detailed report fields once the candidate submits.
Store the result payload against the candidate record in your ATS, mapping the numeric score and completion timestamp.
Known gotchas
Inviting a candidate to a draft (unpublished) test returns a success-like response but the candidate never receives an email — always verify test state before bulk sends.
Bulk fetch endpoints support sorting and filtering via comma-separated query params; omitting filters on large accounts can trigger pagination timeouts, so always page through results.
Score fields are not guaranteed to be populated immediately after submission — allow for processing latency before treating a null score as a failed attempt.
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