Confirm your TestGorilla subscription is on a Plus or External Recruitment plan, as API access is not available on lower-tier plans.
Authenticate with the TestGorilla REST API using the API key available in your account settings.
Create or reference an existing assessment and use the API to invite a candidate by supplying their email and the assessment ID.
Register a webhook URL in your TestGorilla account settings to receive candidate attempt status events, specifically OrderInProgress and OrderComplete payloads.
Parse the incoming webhook payload when OrderComplete fires — extract the candidate identifier, score breakdown per test type, and a link to the full report.
Map the result fields to your ATS candidate record and trigger any downstream stage-change logic based on score thresholds.
Known gotchas
Webhook delivery is not guaranteed to be exactly once — implement idempotency using the attempt ID in the payload so duplicate deliveries do not create duplicate ATS records.
API access is gated by subscription plan; attempting API calls on an ineligible plan returns authentication or permission errors that may be mistaken for credential problems.
Score normalization differs across test types within the same assessment — compare candidates on a per-test-type basis rather than treating the aggregate as a single comparable figure.
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