---
title: HTTP Webhook Configuration
url: https://docs.kaltura.com/docs/rich-media-cms-apis/integration/webhooks-http-config
---

## HTTP Webhook Configuration

After cloning, configure your template's delivery settings using the `update` action.

### Set Webhook URL and Payload

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/eventnotification_eventnotificationtemplate/action/update" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "id=$TEMPLATE_ID" \
  -d "eventNotificationTemplate[objectType]=KalturaHttpNotificationTemplate" \
  -d "eventNotificationTemplate[url]=https://myapp.example.com/webhooks/kaltura" \
  -d "eventNotificationTemplate[method]=2" \
  -d "eventNotificationTemplate[contentType]=2" \
  -d "eventNotificationTemplate[data][objectType]=KalturaHttpNotificationObjectData" \
  -d "eventNotificationTemplate[data][format]=1" \
  -d "eventNotificationTemplate[data][apiObjectType]=KalturaBaseEntry"
```

### Updatable HTTP Fields

| Field | Type | Description |
|-------|------|-------------|
| `url` | string | Webhook endpoint URL |
| `method` | integer | 1=GET, 2=POST |
| `contentType` | integer | 1=form-encoded, 2=JSON, 3=XML, 4=text |
| `data[objectType]` | string | Payload type (see section 10) |
| `signSecret` | string | HMAC signing secret (write-only) |
| `secureHashingAlgo` | integer | Hash algorithm: 1=SHA1, 2=SHA256, 3=SHA384, 4=SHA512, 5=MD5 |
| `authUsername` | string | HTTP Basic Auth username (write-only) |
| `authPassword` | string | HTTP Basic Auth password (write-only) |
| `authenticationMethod` | integer | 1=BASIC, 2=DIGEST, 4=GSSNEGOTIATE, 8=NTLM |
| `customHeaders` | array | Custom HTTP headers |
| `userParameters` | array | Template-level static parameters |

### Custom Headers

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/eventnotification_eventnotificationtemplate/action/update" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "id=$TEMPLATE_ID" \
  -d "eventNotificationTemplate[objectType]=KalturaHttpNotificationTemplate" \
  -d "eventNotificationTemplate[customHeaders][0][objectType]=KalturaKeyValue" \
  -d "eventNotificationTemplate[customHeaders][0][key]=X-Source-System" \
  -d "eventNotificationTemplate[customHeaders][0][value]=kaltura" \
  -d "eventNotificationTemplate[customHeaders][1][objectType]=KalturaKeyValue" \
  -d "eventNotificationTemplate[customHeaders][1][key]=X-Environment" \
  -d "eventNotificationTemplate[customHeaders][1][value]=production"
```

### HTTP Authentication

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/eventnotification_eventnotificationtemplate/action/update" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "id=$TEMPLATE_ID" \
  -d "eventNotificationTemplate[objectType]=KalturaHttpNotificationTemplate" \
  -d "eventNotificationTemplate[authUsername]=webhook-user" \
  -d "eventNotificationTemplate[authPassword]=secret-password" \
  -d "eventNotificationTemplate[authenticationMethod]=1"
```

### User Parameters (Static Tokens)

User parameters store static values on the template. Reference them as `{key}` in the URL or payload.

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/eventnotification_eventnotificationtemplate/action/update" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "id=$TEMPLATE_ID" \
  -d "eventNotificationTemplate[objectType]=KalturaHttpNotificationTemplate" \
  -d "eventNotificationTemplate[userParameters][0][objectType]=KalturaEventNotificationParameter" \
  -d "eventNotificationTemplate[userParameters][0][key]=environment" \
  -d "eventNotificationTemplate[userParameters][0][value][objectType]=KalturaStringValue" \
  -d "eventNotificationTemplate[userParameters][0][value][value]=production"
```

### Delayed Dispatch

Delay webhook delivery until the entry reaches READY status (useful for upload/transcoding events):

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/eventnotification_eventnotificationtemplate/action/update" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "id=$TEMPLATE_ID" \
  -d "eventNotificationTemplate[objectType]=KalturaHttpNotificationTemplate" \
  -d "eventNotificationTemplate[eventDelayedCondition]=1"
```