---
title: "Update webhook configuration"
method: PATCH
path: "/radar/operator/v1/webhooks"
tags: ["Webhooks"]
---

# Update webhook configuration

`PATCH /radar/operator/v1/webhooks`

## Request body

- object
  - `delivery` object — Webhook delivery configuration
    - `webhook_url` string — URL to send webhook events to
    - `webhook_secret` string — Secret used to sign webhook payloads
  - `event_aggregation` 'per_event' | 'per_session' — Delivery mode. `per_session` (recommended) groups all events of a session into one payload sent after the session ends. `per_event` pushes each event in near real-time. `per_event` is not available while identifications are enabled.

## Response `200`

Webhook configuration updated successfully

- object
  - `success` boolean
  - `data` IngestPipelineConfigurationPipelineConfiguration[]
    - `delivery` IngestPipelineConfigurationDelivery
      - `webhook_url` string, required
      - `signature` string, nullable
    - `event_aggregation` 'per_event' | 'per_session' — Delivery mode. `per_session` groups all events of a session into one payload sent after the session ends; `per_event` pushes each event in near real-time.
  - `message` string

## Other responses

- `403` — You don't have permission to do this
- `422` — Validation error

---

[API](https://skmtc.dev/snitcher/apis/snitcher-api.md) · [All operations](https://skmtc.dev/snitcher/apis/snitcher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snitcher/snitcher-api/revisions/cb6fa68e7c8e/schema)