Submission Submitted

The submission.submitted event is triggered when a student submits their work for an assignment.

Caution

A submission that was returned by the teacher can be re-submitted, so you may receive multiple submission.submitted events for the same submission id. Use submitted_at to distinguish attempts.

Caution

A teacher can also undo a returned or completed grading action, which moves the submission back to the submitted state without emitting a webhook event. If your integration mirrors submission states, treat the event stream as eventually consistent and reconcile periodically via the Admin API.

Caution

Submission events are delivered asynchronously with independent retries, so they may arrive out of order, and the data payload reflects the submission at delivery time — data.state can differ from the event type if the submission changed in between. Treat data.state and the timestamps (submitted_at, checked_at, updated_at) as authoritative rather than the arrival order.

Event Properties

Property	Type	Description
id	string	Unique identifier for the submission (UUID)
state	string	Current state of the submission (submitted)
title	string	Title of the submission
content	string	Text content of the submission
submitted_at	string	Timestamp when the student submitted
checked_at	string	Timestamp when grading was completed (absent until completed)
created_at	string	Timestamp when the submission was created
updated_at	string	Timestamp when the submission was last updated
assignment	object	The assignment being submitted to (id, name, course_id)
student	object	The submitting student (id, name, email)

Example Payload

All timestamps are in ISO 8601 format and include a timezone offset (e.g. +08:00). Properties with empty values are omitted from the payload.

{
  "type": "submission.submitted",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "state": "submitted",
    "title": "My Week 1 Homework",
    "content": "Here is my answer to the exercises...",
    "submitted_at": "2024-03-22T10:30:00+08:00",
    "created_at": "2024-03-22T10:29:00+08:00",
    "updated_at": "2024-03-22T10:30:00+08:00",
    "assignment": {
      "id": "660e8400-e29b-41d4-a716-446655440111",
      "name": "Week 1 Homework",
      "course_id": "770e8400-e29b-41d4-a716-446655440222"
    },
    "student": {
      "id": "880e8400-e29b-41d4-a716-446655440333",
      "name": "Test Student",
      "email": "student@example.com"
    }
  }
}