Webhooks

Overview

Webhooks allow your application to receive real-time HTTP POST notifications when events occur. Configure your webhook endpoint URL in the dashboard settings, and we'll send event data as JSON to your endpoint.

Supported Events

Payload Example

Example payload for the website.generated event:

{
  "event": "website.generated",
  "timestamp": "2026-07-21T10:30:00Z",
  "data": {
    "project_id": 12345,
    "project_name": "Coffee Shop Landing Page",
    "preview_url": "https://aiwebsitebuilder.startupitsolution.in/preview/12345",
    "pages": 1,
    "credits_used": 5,
    "credits_remaining": 95
  }
}

Signature Verification

Every webhook request includes a signature in the X-Webhook-Signature header. Verify the signature by computing an HMAC-SHA256 hash of the raw request body using your webhook secret:

// PHP example
$signature = hash_hmac('sha256', $rawBody, $webhookSecret);
if (hash_equals($signature, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'])) {
    $payload = json_decode($rawBody, true);
    // Process the event
}

Retry Policy

If your endpoint returns a non-2xx status code, we will retry the delivery with exponential backoff:

• Retry 1: After 1 minute
• Retry 2: After 5 minutes
• Retry 3: After 30 minutes
• Retry 4: After 2 hours
• Retry 5: After 6 hours (final attempt)

Your endpoint must respond within 10 seconds with a 2xx status code to be considered successful.