Webhooks

Receive real-time notifications when events occur in your project.

Available Events

Request Headers

Payload Example

waitlist.signup

{
  "event": "waitlist.signup",
  "timestamp": "2024-01-20T14:30:00Z",
  "data": {
    "subscriber": {
      "id": 1250,
      "email": "[email protected]",
      "name": "John Doe",
      "position": 1250,
      "referral_code": "abc123"
    },
    "project": {
      "id": 42,
      "name": "MyAwesomeApp",
      "subdomain": "myapp"
    }
  }
}

changelog.published

{
  "event": "changelog.published",
  "timestamp": "2024-01-20T15:00:00Z",
  "data": {
    "post": {
      "id": 15,
      "title": "New Feature Release",
      "type": "new",
      "version": "2.0.0",
      "url": "https://myapp.premonize.com/changelog/new-feature-release"
    }
  }
}

Signature Verification

Verify the X-Premonize-Signature header to ensure requests are authentic

// PHP Example
$signature = hash_hmac(
    'sha256',
    $payload,
    $webhook_secret
);

if (hash_equals($signature, $received_signature)) {
    // Valid signature
}

// Node.js Example
const crypto = require('crypto');

const signature = crypto
  .createHmac('sha256', webhookSecret)
  .update(payload)
  .digest('hex');

if (signature === receivedSignature) {
  // Valid signature
}

Retry Policy

Failed webhook deliveries are automatically retried:

• First retry: 1 minute after failure
• Second retry: 5 minutes after first retry
• Third retry: 30 minutes after second retry