---
title: "Create a Webhook"
method: POST
path: "/webhooks"
---

# Create a Webhook

`POST /webhooks`

Create a new webhook

## Request body

- object
  - `name` string, required — The name of the webhook
  - `action` 'metric' | 'override' | 'device' | 'setPlaylist', required — The action to take on webhook trigger
  - `action_parameters` object — The parameters for the action
  - `filter` string — Filter for the action
  - `query` string — pass a value to metric
  - `override_duration` integer
  - `pause_override_on` string — property to pause override on
  - `play_override_on` string — property to play override on
  - `commands` 'nextpage' | 'previouspage' | 'pause/resume' | 'restart' | 'identify' | 'debug' — set a command for device control webhook

## Response `200`

200

- object
  - `account_id` string
  - `action` string
  - `action_parameters` object
    - `id` string
  - `command` string
  - `id` string
  - `name` string
  - `tag` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/telemetrytv/apis/user-api.md) · [All operations](https://skmtc.net/telemetrytv/apis/user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/telemetrytv/user-api/versions/057a0b968aea/schema)