Authenticate with the CodeSignal API using credentials provided through the employer developer documentation; CodeSignal uses a GraphQL API rather than REST.
Query the companyTests object to retrieve the list of available assessments and their IDs within your organization.
Create an assessment session for the candidate via the GraphQL mutation, optionally specifying a custom redirect URL so the candidate lands back in your application flow after completion.
Store the session link and pass it to the candidate via your ATS communication workflow.
Poll or subscribe to result availability; according to CodeSignal documentation, results propagate to the API within roughly 30 seconds of submission in most cases.
Ingest the result payload into the ATS candidate profile, including score, integrity review indicators, and any labels applied during assessment configuration.
Known gotchas
CodeSignal's API is GraphQL, not REST — standard REST client libraries require adaptation; use a proper GraphQL client and be precise with query shapes to avoid over-fetching.
ATS integrations for Greenhouse, Lever, Workday, and iCIMS are configured through CodeSignal support, not purely self-serve API; expect a setup coordination step with CodeSignal before live traffic.
Integrity review flags in results have legal sensitivity — do not expose raw flag data to candidates or in unsecured logs.
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