Register a custom application in your Codility account under Apps and Integrations > Custom Integrations > Create App to receive an API token
Use the API token as a Bearer token in the Authorization header on all requests to the Codility API; consult the official documentation at codility.com/api-documentation for current endpoint paths
To invite a candidate to a test, call the candidate invitation endpoint with the candidate's email address, the test ID, and any optional parameters such as a custom deadline or language restriction
Poll the candidate result endpoint using the candidate ID or session ID returned from the invitation response to check completion status
When the result status indicates completion, retrieve the score, report URL, and task-level breakdown from the result endpoint
Set up webhooks in the Codility dashboard (if available for your plan) to receive push notifications on test completion instead of polling
Known gotchas
API access in Codility is plan-dependent; not all tiers include API or webhook access — confirm your plan includes the API feature before building the integration
Test IDs and task IDs are internal Codility identifiers; retrieve them through the API or from the Codility dashboard rather than constructing them manually
The Codility API is not as extensively documented as some competitors; treat undocumented fields as unstable and pin to documented fields only to avoid breakage on Codility updates
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