---
title: "Create usage webhook subscription"
method: POST
path: "/usage/v1/subscriptions"
tags: ["Usage"]
---

# Create usage webhook subscription

`POST /usage/v1/subscriptions`

Creates a webhook subscription for usage, balance, and billing events.

## Request body

- object
  - `callbackUrl` string, uri, required
  - `eventTypes` string[]
  - `signingSecret` string

## Response `201`

Usage webhook subscription created successfully

## Other responses

- `400` — Invalid request payload
- `401` — Invalid API key or session
- `403` — Insufficient permissions

---

[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/revisions/5b7e64e6d6f9/schema)