> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Webhooks

> Webhooks in Treble allow you to receive real-time notifications about important platform events, such as HSM state changes, session closures, or deployment failures.

## What is the webhook center?

The Treble webhook center is where you can configure the URLs of your endpoints to receive real-time notifications about relevant platform events.

When an event occurs, Treble sends an HTTP **POST** request to the URL you configure, including a **JSON** in the body with the event information. Your server can process this information to execute specific actions such as updating records, sending alerts, or initiating internal processes.

## Available event types

Currently, you can subscribe to different types of global events:

* **HSM Status Update:** Notifies when an HSM changes state.
* **Session Close Update:** Notifies when a conversation session is closed.
* **Deployment Failure:** Notifies when an error occurs during a deployment.

Each of these webhooks can be activated or deactivated according to your needs from the configuration panel.

## Requirements

* Your endpoint must respond in less than **5 seconds**.
* The response must be a **valid JSON body**.
* It's recommended to use **HTTPS** for greater security.

## Basic example

Here's an example in **Node.js** to handle a Treble webhook:

```javascript theme={null}
const express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook', (req, res) => {
  const { event_type } = req.body;

  console.log('Event received:', event_type);

  // Process the event according to its type
  switch (event_type) {
    case 'hsm.status':
      // Logic to handle HSM state changes
      break;
    case 'session.close':
      // Logic to handle session closure
      break;
    case 'deployment.failure':
      // Logic to handle deployment failures
      break;
  }

  res.status(200).json({ success: true });
});

app.listen(3000, () => console.log('Webhook server listening on port 3000'));
```