Webhooks

IDK provides facilities for ingesting inbound webhooks and emitting outbound callbacks.

Capabilities

  • Inbound webhook logging and retention with admin UI
  • Validation and signature handling via mixins
  • Management command to prune old webhook logs

Sources we listen to

IDK consumes webhooks from common external systems to keep data in sync and trigger workflows:

  • ClickUp: task and space-related events
  • Pipedrive: deals, activities, and organization updates
  • Front: inbox and conversation events
  • QuickBooks: accounting entity change notifications

Code pointers

  • App: idk/webhooks/
  • Models: idk/webhooks/models.py
  • Mixins: idk/webhooks/mixins.py
  • Admin templates: idk/webhooks/templates/admin/webhooks/
  • Pruning command: manage.py prune_webhook_logs

Operations

  • Configure endpoints in your project URLs and point external systems to them
  • Use the admin UI to inspect inbound webhook payloads when debugging

Next steps

  • Add examples of inbound endpoint views and outbound emitters
  • Document signing/verification patterns per integration