---
title: "Set Webhook Config"
method: PUT
path: "/v1/integrations/webhook"
tags: ["integrations"]
---

# Set Webhook Config

`PUT /v1/integrations/webhook`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/integrations/webhook`
- Auth: none declared

Configure or clear the org partner webhook URL.

# legacy: web moved to webhooks.configure@1 on 2026-09-28 (web-caps slice 14; there, the first URL also
# generates the signing secret). API keys with claims:write still use this route.

Requires admin/owner (session) or API key with ``integrations:write``.

## Request body

- WebhookConfigRequest
  - `webhook_url` string, nullable: HTTPS URL to receive partner events. Pass null/empty to clear.

## Response `200`

Successful Response

- WebhookConfigResponse
  - `org_id` string, required
  - `webhook_url` string, nullable
  - `has_signing_secret` boolean
  - `events` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zicron/apis/zicron-api.md) · [All operations](https://skmtc.dev/zicron/apis/zicron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zicron/apis/zicron-api/revisions/abe62e22aa46?raw)