Webhooks Overview

Webhooks allow you to receive real-time notifications when events occur in your PackEdge account.

How Webhooks Work

1. You configure a webhook URL in the PackEdge console
2. When an event occurs (e.g., license activated), PackEdge sends an HTTP POST to your URL
3. Your server processes the event and returns a 200 status code

Setup

1. Go to Settings > Integrations in the console
2. Click Add Webhook
3. Enter:
   • Name: A descriptive name for the webhook
   • URL: Your endpoint URL (must be HTTPS)
   • Signing secret: Pre-filled with a generated secret; keep it, regenerate it, or paste your own (16+ characters)
   • Events: Search and select the events to receive (by name or description, or a whole group at once) — only these are delivered (at least one)
4. Save the webhook. Events and name/URL can be changed later from the webhook's page

Webhook Payload

All webhooks use this format:

{
  "event": "license.activated",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    // Event-specific data
  }
}

Managing Webhooks

From the console, you can:

• Test — Send a test payload to verify your endpoint
• Regenerate Secret — Generate a new signing secret (old one stops working immediately)
• Enable/Disable — Temporarily pause webhook delivery
• Delete — Remove the webhook

Testing Webhooks

Use the Test button to send a test payload:

{
  "event": "test",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "message": "This is a test webhook"
  }
}

Retry Policy

Failed webhook deliveries (non-2xx responses) are not currently retried. Ensure your endpoint:

• Returns 200 status code on success
• Responds within 10 seconds
• Is available and accessible

Next Steps

• Events — Complete list of available events
• Security — Verify webhook signatures