---
title: "POST /v1/webhooks/license-status — Subscribe to license status webhooks."
method: POST
path: "/v1/webhooks/license-status"
tags: ["Webhooks"]
---

# POST /v1/webhooks/license-status — Subscribe to license status webhooks.

`POST /v1/webhooks/license-status`

## Request

- Base URL: `https://api.stockfilm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stockfilm.com/v1/webhooks/license-status`
- Auth: API key in header `Authorization`

## Request body

- CreateStatusWebhookRequest: Request body for webhook status subscription endpoints.
  - `signing_secret` string, nullable: Optional HMAC secret. If omitted, the server generates one.
  - `url` string, required: HTTPS endpoint that receives signed webhook POSTs.

## Response `200`

License-status webhook subscription created

- CreateStatusWebhookResponse: Response body for webhook status subscription endpoints.
  - `created_at` string, date-time, required
  - `event_types` string[], required
  - `status` string, required
  - `subscription_id` string, uuid, required
  - `url` string, required

## Other responses

- `400`: Invalid URL

---

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