attempt.graded
EVENT attempt.graded
An attempt's grade is final
Trigger
Every question of the attempt has been graded — straight after submission for an automatically graded exam, after a person grades the rest otherwise.
The event a gradebook should listen for: score, percent and passed are final. The values are sent whatever the exam's result-release policy says; a receiver that shows them to the examinee should respect the policy itself.
Payload fields
| Field | Type | Meaning |
|---|---|---|
attempt_id |
integer |
|
exam_id |
integer |
|
exam_title |
string |
|
user_id |
integer|null |
|
guest_email |
string|null |
|
examinee_name |
string |
|
attempt_number |
integer |
|
status |
string |
|
passed |
boolean |
|
is_graded |
boolean |
|
score |
number |
|
max_score |
number |
|
percent |
number |
|
submitted |
string |
|
result_url |
string |
Payload
{
"event": "attempt.graded",
"timestamp": "2026-10-18T12:51:30+00:00",
"site": "https://your-site.example",
"data": {
"attempt_id": 263,
"exam_id": 7,
"exam_title": "Safety induction",
"user_id": 412,
"guest_email": null,
"examinee_name": "Dana Kovacs",
"attempt_number": 1,
"status": "graded",
"passed": true,
"is_graded": true,
"score": 18,
"max_score": 20,
"percent": 90,
"submitted": "2026-10-18 12:51:30",
"result_url": "https://your-site.example/exams/result/263"
}
}
See also
- Webhook events — envelope, signing and delivery