---
title: "Create a webhook subscription"
method: POST
path: "/v1/webhooks"
tags: ["events", "events"]
---

# Create a webhook subscription

`POST /v1/webhooks`

## Request

- Base URL: `https://lumify.ai`
- URL: `https://lumify.ai/v1/webhooks`
- Auth: HTTP bearer

## Request body

- object

## Response `200`

The created webhook subscription.

- WebhookCreateResponse
  - `id` integer, nullable
  - `url` string, nullable
  - `event_types` string[]: One or more of score, status, line_move, injury. Defaults to [score, status]. line_move requires sport or event_id. injury fires only on material/critical status changes (not info reconfirms), 0.5 credits per delivery.
  - `sport` string, nullable: Restrict to one sport slug. Required (or event_id) when event_types includes line_move.
  - `event_id` integer, nullable: Restrict to a single event. Required (or sport) when event_types includes line_move.
  - `is_active` boolean, nullable
  - `created_at` string, nullable
  - `signing_secret` string, nullable: Returned only on create — store it to verify Lumify-Signature.

## Other responses

- `422`: Validation Error

---

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