Skip to main content

Developers

Webhooks

Webhooks let HacknPlan notify external systems when project events occur.

A webhook call is an HTTP POST sent to your endpoint with JSON payload data.

Managing webhooks

Configure webhooks from:

  • Administration -> Webhooks
  • Public API endpoints

A webhook includes:

  • Target URL for POST requests
  • Subscribed events
  • Optional custom headers (for authentication or routing)

The triggering event name is included in request header X-HacknPlan-Event.

Activity and retries

Webhook activity is available for the last 30 days in the webhook details view.

For each call, you can inspect:

  • triggering event
  • status
  • attempts
  • payload
  • response codes and response times

Retry policy:

  • up to 5 automatic retries on failure
  • first retry after 1 hour
  • remaining retries once per day

If all retries fail, the event is marked as failed and project admins are notified.

Automatic disable rule:

  • webhook is disabled when success rate is below 20% in the last 7 days
  • requires at least 20 calls in that window

Admins are notified when this condition is met.