Introduction
What the Scout Select Developer API is and what it can do.
Scout Select's Developer API is a single, scoped GraphQL endpoint that lets partners integrate two things into their own product:
- Certifications - send a candidate a proctored, timed skill certification and read back the result, certificate, and report once it completes.
- Assessments - search and create candidates, search your organisation's assessments, assign a candidate to one, and check report status.
Getting Started
Authenticate and make your first request
Certifications
Catalog, invites, results, and webhooks
Assessments
Candidates, assessments, and report status
Schema Reference
Full generated type reference
Base URL
All requests are POST (or GET for introspection) to a single endpoint:
https://select.getscout.ai/api/developer/graphqlEvery operation - queries and mutations alike - goes through this one URL, following standard GraphQL convention. There is no separate REST surface.
How a typical integration flows
- Read the catalog of what's available to you (certification skills/levels, or your org's assessments).
- Create something for a candidate - a certification invite, a new candidate record, or an assignment.
- Scout Select emails the candidate a link and runs the proctored session.
- You poll a result/status query, or configure a webhook callback, to find out when it's done.
- You read the final result - certificate, score, report URL - once it's released.