Skip to content
Developers & integrations

Receive webhooks and open reports

Reconcile start/finish events with the correct attempt and retrieve the available report.

Guide reviewed:

Configure result delivery

The documented assignment.settings.webhook object accepts start_url and finish_url. When configured, TrustExam sends HTTP POST requests at the start and end of an exam. Optional settings include report_type, post, headers and query.

Match the attempt

  1. Keep your assignment and participant identifiers with the session record.

  2. Supply session_data.external_id if you need to reconcile a specific attempt in your system.

  3. Inspect the configured report format. The backend guide describes assignment_attempt_external_id in the Default format and attemptId in HRTools.

  4. Verify status and timestamps before updating your LMS record.

Reports serve different purposes

report_url opens the attempt report in the TrustExam interface for authorised users. The separate AI report API provides analysis when available and uses its own documented credentials and attempt identifier.

An exam-finish event and an available AI report are different states. Do not treat a missing report as zero risk or a completed human review.

Confirm delivery behaviour

Before rollout, agree authentication, retries, duplicate-event handling and expected timing with the technical team. The public overview does not establish a delivery SLA or a webhook-signature contract. Test reconciliation and protect credentials, participant data and report links.

Official instructions

YOUR NEXT STEP

Still need help?

Reach the right team for your question.

A technical problem

For the camera, microphone, app or equipment check, open support chat inside TrustExam when available in your session. If you cannot sign in, use the contact in your invitation.

Open TrustExam

Access, schedule or results

Contact your exam organiser using the details in your invitation. They handle assignment access and timing, grades, retakes, appeals and individual arrangements.

What to check before contacting them
What to include in a support message
  • Exam name and the step where the problem occurred.
  • The time and your time zone.
  • Exact error text, operating system, and browser or app version.
  • Checks already tried; an error screenshot without exam questions or unnecessary personal data.

Do not include passwords, sign-in codes or identity documents in an ordinary message. Use the exam’s designated identity-check step for documents.