Skip to main content
Webhooks allow you to receive real-time notifications about events happening in your Konstantly platform. Each webhook event contains detailed information about what happened and the relevant resources.

Event Types

Course Events

event
Triggered when a course is published
event
Triggered when a course is unpublished
event
Triggered when a course is assigned to a user
event
Triggered when a user starts a course
event
Triggered when a user makes progress in a course
event
Triggered when a user completes a course

User Events

event
Triggered when a new user is created
event
Triggered when user information is updated

Group Events

event
Triggered when a user is added to a group

Common Properties

All webhook events share these common properties:
integer
required
Timestamp when the event occurred
string
required
Event type identifier
object
required
Event-specific payload data

Best Practices

  1. Webhook Handling:
  • Implement proper error handling
  • Use retry logic for failed deliveries
  • Process webhooks asynchronously
  • Validate webhook signatures
  • Respond quickly (2xx status)
  1. Security:
  • Use HTTPS endpoints
  • Validate event data
  • Keep endpoint URLs secret
  • Monitor for unusual patterns
  1. Implementation Tips:
  • Store raw webhook data
  • Process events idempotently
  • Set reasonable timeouts
  • Log webhook failures

Testing Webhooks

  1. Event History:
  • Use GET /webhook/:event/last to fetch recent events
  • Test handling with real event data
  • Verify payload processing
  1. Development:
  • Set up test environment endpoints
  • Use event simulator when available
  • Test all event types
  • Verify error handling