# Setup & Configuration

Webhooks send real-time notifications from Zimark to your endpoint when specific events occur.

Webhooks are HTTP callbacks sent to your endpoint when triggered events occur. This eliminates polling and enables real-time synchronization with your systems.

**Supported Event Types:**

- **Manifest Events**: Status changes, updates, asset dispatch status change
- **Gate Events**: Status changes, unauthorized loading added, unauthorized loading resolved


## Create a Webhook

### Prerequisites

- ✅ HTTPS endpoint accessible to receive POST requests
- ✅ Ability to parse JSON payloads and return 200/201/202 status codes
- ✅ Endpoint responds within 30 seconds
- ✅ Handle duplicate deliveries using `eventIdentifier` (see [Webhooks](/webhooks/webhooks))


### Step 1: Navigate to Webhook Configuration

1. Log into your Zimark administration panel
2. Navigate to **Administration** → **Webhooks**
3. Click **"Add webhook"**


### Step 2: Configure Basic Settings

![Webhook Configuration Form](/assets/webhook-form.e24a27c2ab5a3c6ceaec8934ec378a4316f212b67d1c6235817a1ec96db56f17.ba64c942.png)

**Required Fields:**

- **Name**: Description for this webhook configuration
- **Webhook URL**: Your HTTPS endpoint (e.g., `https://your-domain.com/webhooks/zimark`)
- **Event Types**: Select which events trigger this webhook
- **Active Status**: Enable or disable the webhook


### Step 3: Configure Authentication (Optional)

Add custom headers if your endpoint requires authentication:

![Webhook Form with Authentication](/assets/webhook-form-with-auth.73f91b690ea470a97e1b30235bbcf1281db5cc3232c88d04eff814aa572165f7.ba64c942.png)

**Security**: Always use HTTPS endpoints and implement authentication.

### Step 4: Configure Retry Policy (Optional)

![Retry Policy Configuration](/assets/retry-policy-form.7c81b68bb8d4dd65cc3f5fc0e43edeb92d0583466128bc729f2bddb325f02cf6.ba64c942.png)

**Retry Options:**

- **Maximum Retries**: Number of retry attempts for failed deliveries (default: 3)
- **Retry Intervals**: Duration between retries using exponential backoff
- **Backoff Strategy**: Constant or exponential interval calculation