Skip to main content

Webhooks

Receive instant notifications when events occur in your Unizo ecosystem through configurable HTTP callbacks.

Configuration​

You can create webhook endpoints for different integration categories:

  1. Navigate to Webhooks

    Go to Setup Integrations > Webhooks tab from the left menu in your Unizo console

Unizo Sign Up Form

Select Webhooks

  1. Create Webhook

    Click Create Callback URL to set up a new webhook:

    • Category: Choose integration type (Source Code, Ticketing, Platform)
    • Callback URL: Your HTTPS endpoint to receive webhook requests
    • Content Type: Select application/json (recommended)
    • Secret: Add security key for payload validation
Unizo Sign Up Form

Create Webhook

  1. Submit Configuration

    Click Submit to save the webhook endpoint

Payload Structure​

All webhook payloads follow a consistent JSON structure:

{
  "event": "repository.push",
  "timestamp": "2024-01-15T10:30:00Z",
  "source": {
    "type": "github",
    "integration_id": "integration_123"
  },
  "data": {
    // Event-specific data
  }
}

Security​

Signature Verification​

Unizo signs all webhook payloads using HMAC-SHA256. Verify signatures to ensure authenticity:

Request Headers:

  • X-Unizo-Signature: HMAC-SHA256 signature
  • X-Unizo-Timestamp: Request timestamp
  • Content-Type: application/json

Verification Process:

  1. Extract the signature from the X-Unizo-Signature header
  2. Create an HMAC-SHA256 hash of the request body using your secret
  3. Compare the computed signature with the received signature
  4. Verify the timestamp is within acceptable range (prevent replay attacks)

For additional support, contact our team at support@unizo.ai.