API and automation

Connect proctoring to any system, with or without code.

Invite candidates and pull sessions with the REST API, receive signed results by webhook, automate with Zapier, Make or n8n, and send events to your LRS with xAPI.

For privacy, this animation was created with AI and shows no real people. Try the system yourself →

Ways to connect

Pick the one that fits

REST API

Invite and read

Invite candidates, list exams, sessions and events, and manage event subscriptions.

Webhooks

Signed results

When a session ends, the candidate ID and risk summary are sent to your URL as signed JSON.

No-code

Zapier, Make, n8n

Subscribe to session started, finished, high risk, raised hand and activation events without writing code.

xAPI

Learning record store

Events go to your LRS as xAPI statements: attempted, completed, flagged, asked, registered.

Platform

Your own exam engine

Your platform runs the exam, QProctor proctors it, and the result returns to you as a signed notification.

ATS

Hiring systems

Greenhouse, Lever, Workday, Workable, BambooHR and iCIMS, set up per organisation.

Quick start

One call to test your key

Bearer key, scoped permissions

Create a key in the QProctor panel under the API settings. The key is shown only once, when it is created. Test the connection first, then invite candidates; the invite response returns the candidate’s exam link.

  • Expiry: 30, 90, 180 or 365 days, or no expiry
  • Each key gets only the permissions you select
  • Unauthorised calls return 403; expired keys return 401
curl https://YOUR-PANEL/api/v1/ben \
  -H "Authorization: Bearer qp_YOUR_KEY"
Connection test. Fields and sample JSON for every endpoint are in the API screen of the panel.
REST API · /api/v1

Endpoints and scopes

EndpointScopeWhat it does
GET /ben—Connection test
GET /sinavlarokuList exams
GET /oturumlaroturum_okuSessions and results (personal data)
GET /olaylar/{event}/ornekokuSample JSON for an event type
POST /kancalarkancaSubscribe to an event (REST Hooks)
DELETE /kancalarkancaRemove a subscription
POST /adaylaraday_davetInvite a candidate and get the exam link
Delivery and security

Signed and retried

Signature
HMAC-SHA256 signature in the X-Proctor-Signature header; verification samples for Python and Node.js in the panel
Retries
If your endpoint does not return 2xx, up to 3 retries; de-duplicate by session_id
Event codes
62 event types; reports, webhooks and the API use the same codes and risk weights
Risk score
0–100, built from weighted events

Risk scores and flags are evidence for a human reviewer. Your system should not make automatic decisions about candidates from them.

FAQ

Developer questions

Can we connect without developers?

Yes. Use Zapier, Make or n8n to react to QProctor events without code.

Is the API available on the free trial?

Create a free account and generate a key in the API settings to test the connection.

Which ATSs do you integrate with?

Greenhouse, Lever, Workday, Workable, BambooHR and iCIMS. ATS integrations are set up per organisation.

How do we verify a webhook really came from QProctor?

Check the HMAC-SHA256 signature in the X-Proctor-Signature header against your secret.

Create your key and make your first call today

Open a free account, create a key in the API settings and test the connection.

Start free