masterdata.student.dropped

The masterdata.student.dropped event is triggered when a student is marked as dropped in Jodo.

Overview

Use this event to mark the student as inactive or dropped in your ERP while preserving historical payments, plans, and reconciliation records.

Payload

Attribute	Type	Description
event_id	String	Unique identifier for the webhook event.
event	String	Event name: masterdata.student.dropped.
timestamp	Integer	Unix timestamp when the event was originated.
version	String	Webhook payload version.
payload	Object	Event payload.
payload.jodo_student_id	String	Jodo student identifier.
payload.student	Object	Student profile details at the time of the event.
payload.student.identifier	String	Student identifier from your system.
payload.student.custom_identifier	String	Optional custom identifier associated with the student.
payload.student.collector_code	String or null	Collector or branch code, when configured.
payload.student.grade	Object	Student grade details.
payload.student.grade.code	String	Grade code.
payload.student.grade.name	String	Grade name.
payload.student.academic_year_start	Integer	Start year of the student’s academic year.
payload.student.academic_year_end	Integer	End year of the student’s academic year.
payload.student.primary_contact_number	String	Primary parent or guardian contact number.
payload.student.primary_contact_email	String	Primary parent or guardian email address.
payload.student.notes	Array	Additional student metadata.
payload.student.notes[].key	String	Metadata key.
payload.student.notes[].value	String	Metadata value.

Example

{
  "event": "masterdata.student.dropped",
  "event_id": "f8093bb5-29c7-4b3a-a99b-298520233820",
  "version": "1.0",
  "timestamp": 1655448963,
  "payload": {
    "jodo_student_id": "student_1234",
    "student": {
      "identifier": "1234",
      "custom_identifier": "cust_1234",
      "collector_code": null,
      "grade": {
        "code": "M1BLUE",
        "name": "Montessori 1"
      },
      "academic_year_start": 2022,
      "academic_year_end": 2023,
      "primary_contact_number": "9876543210",
      "primary_contact_email": "parent@example.com",
      "notes": [
        {
          "key": "registration_number",
          "value": "REG12345"
        }
      ]
    }
  }
}

Handling the Event

• Mark the student as dropped or inactive in your ERP.
• Keep historical payment, subscription, and reconciliation records intact.
• Use payload.jodo_student_id and your ERP identifiers to update the correct record.
• Treat repeated deliveries with the same event_id as duplicates.