Webhooks

Enterprise Only

Receive real-time notifications about events in your account.

Available Events

• plugin.installed - When a plugin is installed
• plugin.updated - When a plugin is updated
• plugin.uninstalled - When a plugin is uninstalled
• subscription.changed - When subscription tier changes

Payload Format

Each webhook event includes an event type, timestamp, and event-specific data.

plugin.installed / plugin.updated:

{
  "event": "plugin.installed",
  "timestamp": "2024-12-05T15:30:00Z",
  "data": {
    "plugin_id": "plugin_abc123",
    "plugin_name": "Workflow Automator",
    "version": "2.1.0",
    "user_id": "user_xyz789"
  }
}

plugin.uninstalled:

{
  "event": "plugin.uninstalled",
  "timestamp": "2024-12-05T15:35:00Z",
  "data": {
    "plugin_id": "plugin_abc123",
    "plugin_name": "Workflow Automator",
    "user_id": "user_xyz789",
    "uninstalled_at": "2024-12-05T15:35:00Z"
  }
}

Signature Verification

Verify webhook authenticity using the X-Dryade-Signature header:

import hmac
import hashlib

def verify_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)