File Storage Webhooks

Webhooks enable your applications to receive real-time notifications when events occur in your file Storage and issue tracking systems. This eliminates the need for polling and ensures your systems stay synchronized with ticket updates, status changes, comments, and attachment activities across all integrated platforms.

Unizo normalizes webhook events from Jira, ServiceNow, Zendesk, GitHub Issues, and other file Storage providers into a consistent format. This means you write your webhook handler once and it works with all supported platforms.

Webhook Configuration

To set up webhooks for your integration, visit the Unizo Console Webhooks section for step-by-step configuration guide.

Supported Event Types

These are the event types currently supported by Unizo's File Storage webhooks. The list keeps growing as we add support for more events across different platforms.

Event Type	Description	Trigger Conditions
file:created	A new file has been created	File creation via UI, API, email, or automation
file:updated	File information has been modified	Title, description, status, priority, or assignee changes
file:deleted	A file has been deleted	File deletion or permanent removal

Webhook Security

All webhooks from Unizo include security headers to verify authenticity:

Headers

Header	Description
x-unizo-event-type	The type of event that triggered the webhook
x-unizo-signature	HMAC SHA-256 signature for request validation
x-unizo-timestamp	Unix timestamp when the event was sent
x-unizo-delivery-id	Unique identifier for this webhook delivery

Signature Verification

Verify the authenticity of incoming webhooks using HMAC SHA-256:

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature, 'hex'),
    Buffer.from(expectedSignature, 'hex')
  );
}

File Events

File Created

file:created

Triggered when a new file is created in the file Storage system

POSThttps://api.yourapp.com/webhooks/unizo/file Storage

Headers

Name	Type	Required	Description
x-unizo-event-type	string	Yes	Event type: file:created
x-unizo-signature	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description

Example Payload

{
  "type": "file:created",
  "version": "1.0.0",
  "contentType": "application/json",
  "file": {
    "id": "10099",
    "name": "NewProject"
  },
  "integration": {
    "type": "FILE_STORAGE",
    "id": "f2ae41b8-6aa9-434b-84ab-ddc0a7321351",
    "name": "Ji_Secu_1756452472351"
  }
}

Response

200 OK	Webhook processed successfully
400 Bad Request	Invalid webhook payload
401 Unauthorized	Invalid or missing signature

File Updated

file:updated

Triggered when file information is modified

POSThttps://api.yourapp.com/webhooks/unizo/file Storage

Headers

Name	Type	Required	Description
x-unizo-event-type	string	Yes	Event type: file:created
x-unizo-signature	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description

Example Payload

{
  "type": "file:updated",
  "version": "1.0.0",
  "contentType": "application/json",
  "file": {
    "id": "10099",
    "name": "NewProject"
  },
  "integration": {
    "type": "FILE_STORAGE",
    "id": "f2ae41b8-6aa9-434b-84ab-ddc0a7321351",
    "name": "Ji_Secu_1756452472351"
  }
}

Response

200 OK	Webhook processed successfully
400 Bad Request	Invalid webhook payload
401 Unauthorized	Invalid or missing signature

File Deleted

file:deleted

Triggered when a file is deleted from the file Storage system

POSThttps://api.yourapp.com/webhooks/unizo/file Storage

Headers

Name	Type	Required	Description
x-unizo-event-type	string	Yes	Event type: file:created
x-unizo-signature	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description

Example Payload

{
  "type": "file:deleted",
  "version": "1.0.0",
  "contentType": "application/json",
  "file": {
    "id": "10099",
    "name": "NewProject"
  },
  "integration": {
    "type": "FILE_STORAGE",
    "id": "f2ae41b8-6aa9-434b-84ab-ddc0a7321351",
    "name": "Ji_Secu_1756452472351"
  }
}

Response

200 OK	Webhook processed successfully
400 Bad Request	Invalid webhook payload
401 Unauthorized	Invalid or missing signature

Need Help?

For webhook-related support:

• Contact support at support@unizo.ai