Public Cloud (Infra) Webhooks

Webhook Configuration

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

Overview

Unizo's Public Cloud (Infra) API provides webhooks to notify your application when important infrastructure events occur across your integrated cloud platforms. These real-time notifications enable you to build automated infrastructure workflows, maintain synchronized resource tracking, and ensure timely response to infrastructure changes.

Our platform normalizes webhook events from various cloud providers (AWS, Azure, Google Cloud, etc.) into a consistent format, making it easy to handle infrastructure events regardless of the underlying platform.

Supported Event Types

Event Type	Description	Trigger Conditions
user:updated	Event broadcast when a user has been updated	User profile or permissions modified
user:deleted	Event broadcast when a user is deleted	User permanently removed
resource:created	Event broadcast when a resource has been created	New resource created
resource:updated	Event broadcast when a resource has been updated	Resource configuration modified
resource:deleted	Event broadcast when a resource is deleted	Resource deleted

User Updated

`user:updated`

Triggered when a user's profile, permissions, or configuration is modified in your cloud platform.

POSThttps://api.yourapp.com/webhooks/unizo/infrastructure

Headers

Name	Type	Required	Description
`x-unizo-event-type`	string	Yes	The type of event that was triggered
`x-unizo-signature`	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description
`type`	string	Yes	Event type identifier
`version`	string	Yes	Webhook payload version
`contentType`	string	Yes	Content type of the payload
`user`	object	Yes	User object
`user.id`	string	Yes	User ID
`user.name`	string	Yes	User display name
`user.email`	string	Yes	User email address
`user.role`	string	No	User role
`user.updatedDateTime`	string	Yes	Update timestamp
`integration.type`	string	Yes	Integration type
`integration.id`	string	Yes	Integration ID
`integration.name`	string	Yes	Integration display name

Example Payload

{
  "type": "user:updated",
  "version": "1.0.0",
  "contentType": "application/json",
  "user": {
    "id": "usr-0012345",
    "name": "John Doe",
    "email": "[email protected]",
    "role": "admin",
    "updatedDateTime": "2026-01-15T14:00:00Z"
  },
  "integration": {
    "type": "INFRASTRUCTURE",
    "id": "906e3a3c-e317-4114-8cd5-38bfacbf02a3",
    "name": "AWS Production"
  }
}

Response

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

User Deleted

`user:deleted`

Triggered when a user is permanently deleted and removed from your cloud platform.

POSThttps://api.yourapp.com/webhooks/unizo/infrastructure

Headers

Name	Type	Required	Description
`x-unizo-event-type`	string	Yes	The type of event that was triggered
`x-unizo-signature`	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description
`type`	string	Yes	Event type identifier
`version`	string	Yes	Webhook payload version
`contentType`	string	Yes	Content type of the payload
`user`	object	Yes	User object
`user.id`	string	Yes	User ID
`user.name`	string	Yes	User display name
`user.email`	string	Yes	User email address
`user.deletedDateTime`	string	Yes	Deletion timestamp
`integration.type`	string	Yes	Integration type
`integration.id`	string	Yes	Integration ID
`integration.name`	string	Yes	Integration display name

Example Payload

{
  "type": "user:deleted",
  "version": "1.0.0",
  "contentType": "application/json",
  "user": {
    "id": "usr-0012345",
    "name": "John Doe",
    "email": "[email protected]",
    "deletedDateTime": "2026-01-15T16:00:00Z"
  },
  "integration": {
    "type": "INFRASTRUCTURE",
    "id": "906e3a3c-e317-4114-8cd5-38bfacbf02a3",
    "name": "AWS Production"
  }
}

Response

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

Resource Created

`resource:created`

Triggered when a new infrastructure resource is created such as a VM, container, database, or other cloud resource.

POSThttps://api.yourapp.com/webhooks/unizo/infrastructure

Headers

Name	Type	Required	Description
`x-unizo-event-type`	string	Yes	The type of event that was triggered
`x-unizo-signature`	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description
`type`	string	Yes	Event type identifier
`version`	string	Yes	Webhook payload version
`contentType`	string	Yes	Content type of the payload
`resource`	object	Yes	Resource object
`resource.id`	string	Yes	Unique resource identifier
`resource.name`	string	Yes	Resource name
`resource.type`	string	Yes	Resource type (vm, container, database, etc.)
`resource.region`	string	Yes	Deployment region
`resource.provider`	string	Yes	Cloud provider
`resource.createdDateTime`	string	Yes	Creation timestamp
`resource.createdBy`	string	No	User or system that created the resource
`integration.type`	string	Yes	Integration type
`integration.id`	string	Yes	Integration ID
`integration.name`	string	Yes	Integration display name

Example Payload

{
  "type": "resource:created",
  "version": "1.0.0",
  "contentType": "application/json",
  "resource": {
    "id": "i-1234567890abcdef0",
    "name": "prod-web-server-01",
    "type": "vm",
    "region": "us-east-1",
    "provider": "aws",
    "createdDateTime": "2026-01-15T14:00:00Z",
    "createdBy": "[email protected]"
  },
  "integration": {
    "type": "INFRASTRUCTURE",
    "id": "906e3a3c-e317-4114-8cd5-38bfacbf02a3",
    "name": "AWS Production"
  }
}

Response

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

Resource Updated

`resource:updated`

Triggered when a resource configuration is modified, including scaling changes, tag updates, or configuration modifications.

POSThttps://api.yourapp.com/webhooks/unizo/infrastructure

Headers

Name	Type	Required	Description
`x-unizo-event-type`	string	Yes	The type of event that was triggered
`x-unizo-signature`	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description
`type`	string	Yes	Event type identifier
`version`	string	Yes	Webhook payload version
`contentType`	string	Yes	Content type of the payload
`resource`	object	Yes	Resource object
`resource.id`	string	Yes	Unique resource identifier
`resource.name`	string	Yes	Resource name
`resource.type`	string	Yes	Resource type
`resource.updatedDateTime`	string	Yes	Update timestamp
`resource.updatedBy`	string	No	User or system that updated the resource
`integration.type`	string	Yes	Integration type
`integration.id`	string	Yes	Integration ID
`integration.name`	string	Yes	Integration display name

Example Payload

{
  "type": "resource:updated",
  "version": "1.0.0",
  "contentType": "application/json",
  "resource": {
    "id": "i-1234567890abcdef0",
    "name": "prod-web-server-01",
    "type": "vm",
    "updatedDateTime": "2026-01-15T15:00:00Z",
    "updatedBy": "[email protected]"
  },
  "integration": {
    "type": "INFRASTRUCTURE",
    "id": "906e3a3c-e317-4114-8cd5-38bfacbf02a3",
    "name": "AWS Production"
  }
}

Response

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

Resource Deleted

`resource:deleted`

Triggered when a resource is deleted, indicating it has been removed from the system.

POSThttps://api.yourapp.com/webhooks/unizo/infrastructure

Headers

Name	Type	Required	Description
`x-unizo-event-type`	string	Yes	The type of event that was triggered
`x-unizo-signature`	string	Yes	HMAC SHA-256 signature

Request Body Schema

Property	Type	Required	Description
`type`	string	Yes	Event type identifier
`version`	string	Yes	Webhook payload version
`contentType`	string	Yes	Content type of the payload
`resource`	object	Yes	Resource object
`resource.id`	string	Yes	Unique resource identifier
`resource.name`	string	Yes	Resource name
`resource.type`	string	Yes	Resource type
`resource.deletedDateTime`	string	Yes	Deletion timestamp
`resource.deletedBy`	string	No	User or system that deleted the resource
`integration.type`	string	Yes	Integration type
`integration.id`	string	Yes	Integration ID
`integration.name`	string	Yes	Integration display name

Example Payload

{
  "type": "resource:deleted",
  "version": "1.0.0",
  "contentType": "application/json",
  "resource": {
    "id": "i-1234567890abcdef0",
    "name": "prod-web-server-01",
    "type": "vm",
    "deletedDateTime": "2026-01-15T16:00:00Z",
    "deletedBy": "[email protected]"
  },
  "integration": {
    "type": "INFRASTRUCTURE",
    "id": "906e3a3c-e317-4114-8cd5-38bfacbf02a3",
    "name": "AWS Production"
  }
}

Response

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

Webhook Delivery & Retries

Unizo implements a robust delivery system with automatic retries to ensure your webhooks are delivered reliably:

Timeout: 30 seconds per delivery attempt
Retry Schedule: 5 attempts with exponential backoff
- Attempt 1: Immediate
- Attempt 2: 1 minute delay
- Attempt 3: 5 minutes delay
- Attempt 4: 30 minutes delay
- Attempt 5: 2 hours delay
Success Criteria: HTTP status codes 200-299
Failure Handling: After 5 failed attempts, the webhook is marked as failed

Best Practices

1. Idempotency

Always implement idempotent webhook handlers using the x-unizo-delivery-id header:

Idempotent Webhook Handler

// Example: Handling webhooks idempotently
app.post('/webhooks/infrastructure', async (req, res) => {
const deliveryId = req.headers['x-unizo-delivery-id'];

// Check if we've already processed this delivery
const existingDelivery = await db.webhookDeliveries.findOne({
  deliveryId
});

if (existingDelivery) {
  console.log(`Duplicate delivery detected: ${deliveryId}`);
  return res.status(200).json({
    status: 'already_processed'
  });
}

// Process the webhook
try {
  await processInfraEvent(req.body);

  // Record the delivery
  await db.webhookDeliveries.create({
    deliveryId,
    processedAt: new Date()
  });

  res.status(200).json({ status: 'success' });
} catch (error) {
  console.error('Webhook processing failed:', error);
  res.status(500).json({ status: 'error' });
}
});

2. Resource Tracking

Track infrastructure resource lifecycle events:

Resource State Tracking

async function processResourceEvent(payload) {
const { resource, type } = payload;

switch (type) {
  case 'resource:created':
    await addToInventory(resource);
    break;

  case 'resource:updated':
    await updateInventory(resource);
    break;

  case 'resource:deleted':
    await removeFromInventory(resource);
    break;

  case 'user:updated':
    await updateUserPermissions(payload.user);
    break;

  case 'user:deleted':
    await revokeUserAccess(payload.user);
    break;
}
}

Need Help?

For webhook-related support:

Contact support at [email protected]

Overview​

Supported Event Types​

User Updated

user:updated

Headers

Request Body Schema

Example Payload

Response

User Deleted

user:deleted

Headers

Request Body Schema

Example Payload

Response

Resource Created

resource:created

Headers

Request Body Schema

Example Payload

Response

Resource Updated

resource:updated

Headers

Request Body Schema

Example Payload

Response

Resource Deleted

resource:deleted

Headers

Request Body Schema

Example Payload

Response

Webhook Delivery & Retries​

Best Practices​

1. Idempotency​

Idempotent Webhook Handler

2. Resource Tracking​

Resource State Tracking

Need Help?​

Overview

Supported Event Types

`user:updated`

`user:deleted`

`resource:created`

`resource:updated`

`resource:deleted`

Webhook Delivery & Retries

Best Practices

1. Idempotency

2. Resource Tracking

Need Help?