Skip to main content

Register a webhook

Webhooks let external systems receive real-time events from ImpartLab.

Before you start​

  • Role required: Admin
  • Setup needed: A publicly reachable HTTPS endpoint that accepts POST requests

Steps​

  1. Go to Platform → Integrations → Webhooks and select New webhook.
  2. Enter the endpoint URL.
  3. Select the events to subscribe to:
    • ptm.booking — parent–teacher meeting booked
    • slip.response — permission slip responded
    • survey.response — survey answered
    • fee.payment — payment recorded
    • result.published — result published
  4. Enter a secret (optional but recommended). Payloads are signed with HMAC-SHA256 over timestamp.payload.
  5. Select Save.
  6. Select Send test to verify your endpoint receives the payload.

Verify the signature​

HMAC-SHA256(secret, timestamp + "." + raw_body)

Compare the result to the X-ImpartLab-Signature header on each delivery.