---
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

## Changes

- **2026-04-07** `fc3c7986659d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/casemark/apis/case-dev-api/changes/usage/v1/subscriptions/post.md)

---

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