How to Configure Webhooks in Live Class

Webhooks allow Live Class to send real-time notifications to your applications whenever specific session or attendance events occur. Instead of repeatedly checking Live Class for updates, your application can automatically receive event notifications when an activity occurs.

You can use webhooks to synchronize session data, track participant activity, monitor attendance, process recordings, and trigger automated workflows in external applications.

What You Can Use Webhooks For

• Track when sessions start and end

• Monitor participant activity in real time

• Track attendance and presence checks

• Receive notifications when recordings are ready

• Synchronize session data with external applications

• Automate attendance and compliance workflows

• Trigger actions when polls are completed

Step 1: Open Webhooks

Navigate to 'Integrations' and select 'Webhooks'.

Step 2: Create a New Webhook

Click '+ Create Webhook'.

Step 3: Configure the Webhook

Enter a 'Name' to identify the webhook and the 'URL' where Live Class should send webhook notifications.

Step 4: Select Webhook Events

Select one or more events that should trigger the webhook. A single webhook can subscribe to multiple events.

Available Webhook Events

Step 5: Create the Webhook

After entering the webhook URL and selecting the required events, click Create.

Live Class creates the webhook and displays it in the Webhooks list.

Step 6: Manage the Webhook

After creating the webhook, you can view its configuration from the 'Webhooks' page.

Use 'Disable' to stop the webhook from receiving event notifications, or click the 'Delete' icon to delete the webhook.

Step 7: Verify Your Webhook

Once your webhook is active:

1. Trigger one of the events selected for the webhook.

2. Confirm that your endpoint receives the webhook request.

3. Check the event type and payload received by your application.

4. Process the event in your application.

5. Return a successful HTTP response to acknowledge receipt.

If the webhook is disabled, it will not receive event notifications.

Sample Webhook Payloads

The following examples show sample payload structures for the events supported by Live Class. The exact fields returned may vary depending on the event and Live Class configuration.

Session Started

The Session Started webhook is triggered when a Live Class session starts.

{
  "event": "session.started",
  "created_at": "2026-09-25T09:30:00Z",
  "data": {
    "session_id": "sess_100001",
    "session_name": "New Employee Orientation",
    "session_type": "classroom",
    "started_at": "2026-09-25T09:30:00Z"
  }
}

Session Ended

The Session Ended webhook is triggered when a Live Class session ends.

{
  "event": "session.ended",
  "created_at": "2026-09-25T10:30:00Z",
  "data": {
    "session_id": "sess_100001",
    "session_name": "New Employee Orientation",
    "ended_at": "2026-09-25T10:30:00Z",
    "duration_minutes": 60
  }
}

Participant Joined

The Participant Joined webhook is triggered when a participant joins a session.

{
  "event": "participant.joined",
  "created_at": "2026-09-25T09:35:12Z",
  "data": {
    "session_id": "sess_100001",
    "participant_id": "user_5001",
    "participant_name": "John Doe",
    "joined_at": "2026-09-25T09:35:12Z"
  }
}

Participant Left

The Participant Left webhook is triggered when a participant leaves a session.

{
  "event": "participant.left",
  "created_at": "2026-09-25T10:20:45Z",
  "data": {
    "session_id": "sess_100001",
    "participant_id": "user_5001",
    "participant_name": "John Doe",
    "left_at": "2026-09-25T10:20:45Z"
  }
}

Recording Ready

The Recording Ready webhook is triggered when a session recording becomes available.

{
  "event": "recording.ready",
  "created_at": "2026-09-25T10:35:00Z",
  "data": {
    "session_id": "sess_100001",
    "recording_id": "rec_7001",
    "session_name": "New Employee Orientation",
    "recording_url": "https://example.com/recordings/rec_7001",
    "ready_at": "2026-09-25T10:35:00Z"
  }
}

Presence Check Issued

The Presence Check Issued webhook is triggered when a presence check is issued during a session.

{
  "event": "presence_check.issued",
  "created_at": "2026-09-25T09:50:00Z",
  "data": {
    "session_id": "sess_100001",
    "check_id": "check_2001",
    "issued_at": "2026-09-25T09:50:00Z"
  }
}

Presence Check Confirmed

The Presence Check Confirmed webhook is triggered when a participant successfully confirms a presence check.

{
  "event": "presence_check.confirmed",
  "created_at": "2026-09-25T09:51:15Z",
  "data": {
    "session_id": "sess_100001",
    "check_id": "check_2001",
    "participant_id": "user_5001",
    "confirmed_at": "2026-09-25T09:51:15Z"
  }
}

Presence Check Missed

The Presence Check Missed webhook is triggered when a participant does not complete a presence check within the required period.

{
  "event": "presence_check.missed",
  "created_at": "2026-09-25T09:53:00Z",
  "data": {
    "session_id": "sess_100001",
    "check_id": "check_2001",
    "participant_id": "user_5002",
    "missed_at": "2026-09-25T09:53:00Z"
  }
}

Attendance Finalized

The Attendance Finalized webhook is triggered when attendance for a session has been finalized.

{
  "event": "attendance.finalized",
  "created_at": "2026-09-25T10:45:00Z",
  "data": {
    "session_id": "sess_100001",
    "attendees": 18,
    "attendance_finalized_at": "2026-09-25T10:45:00Z"
  }
}

Poll Closed

The Poll Closed webhook is triggered when a poll is closed during a session.

{
  "event": "poll.closed",
  "created_at": "2026-09-25T10:05:00Z",
  "data": {
    "session_id": "sess_100001",
    "poll_id": "poll_3001",
    "poll_title": "How useful was this session?",
    "closed_at": "2026-09-25T10:05:00Z"
  }
}

Verify Your Endpoint

Once your webhook is created:

1. Trigger one of the subscribed events in Live Class.

2. Confirm that your endpoint receives an HTTP request.

3. Verify the event type and associated data.

4. Process the event in your application.

5. Return an HTTP 200 OK response to acknowledge successful delivery.

You have successfully configured webhooks in Live Class. Webhooks provide a reliable way to receive real-time session, participant, attendance, recording, and poll events, helping you automate workflows and keep external applications synchronized with Live Class.