- What is TestInvite?
- Build Your First Test
- Run Your First Assessment
- Taking the Assessment
- Viewing the Results
- Question Bank Overview
- Common Question Features
- Scoring
- Question Types
- Question Authoring
- Browsing Questions
- Content Blocks
- Media Library
- Metadata Rules & Schema
- Roles & Access
- Tests Overview
- My Tests
- Creating a Test
- The Test Editor
- Test Settings
- Sections & Pages
- Adding Questions
- Page Builders
- Test Profile
- Reporting
- Test Papers
- Analytics
- Publishing a Test
- Test Library
- Marketplace
- Tasks Overview
- Creating a Task
- Task Dashboard
- Steps
- Task Settings
- Candidates
- Test Sessions
- Sent Mails
- Proctoring
- Analytics
- Analytics Overview
- Test Analytics
- Question Analytics
- Per-Question Analytics
- Results Explorer
- Segment Analysis
Webhooks & Callbacks
Get notified the moment a candidate finishes, instead of polling for results — set a callback URL when you create the candidate and TestInvite posts the result to it automatically.
Rather than polling for a candidate's result, ask TestInvite to tell you the moment it's ready. Pass a callback when you create the candidate:
callback: { url, params?, resource }—urlis your endpoint;paramsare optional extra values echoed back to you so you can match the callback to your own records;resourcechooses whether the posted payload is the session'sbasicordetailedshape, the same shapes documented on Test Sessions & Results.
TestInvite calls your URL once, when the candidate's test session completes — no callback is sent if one wasn't provided at creation time. If your app needs the result and didn't set a callback, fetch it on demand instead (see Integration Workflow).
Zapier's Trigger Is the Same Event, Different Delivery
Zapier's Test Session Completion trigger (see Zapier) fires off the same underlying completion event as this callback — it's just delivered through Zapier's infrastructure instead of a URL you host yourself. Use the REST callback if you're integrating your own backend directly; use Zapier if you want to react to completion without hosting anything.