---
title: "Create vault webhook subscription"
method: POST
path: "/vault/{id}/events/subscriptions"
tags: ["Vaults"]
---

# Create vault webhook subscription

`POST /vault/{id}/events/subscriptions`

Creates a webhook subscription for vault lifecycle events. Optional object filters can limit notifications to specific vault objects.

## Path parameters

- `id` string, required

## Request body

- object
  - `callbackUrl` string, uri, required — Webhook endpoint URL that will receive vault event deliveries
  - `eventTypes` string[] — Vault event types to deliver. Omit to receive the default supported set.
  - `objectIds` string[] — Vault object IDs to limit notifications to. Omit to receive events for all objects in the vault.
  - `signingSecret` string — Optional secret used to sign outbound webhook deliveries

## Response `201`

Vault webhook subscription created successfully

## Other responses

- `400` — Webhook payload is invalid or references unknown vault objects
- `401` — Invalid API key
- `403` — API key does not have write access to vault service
- `404` — Vault not found or access denied

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)