Skip to Content
Mux Docs: Home
Create a webhook
post

Creates a new webhook for the current environment. New webhooks start out enabled. The address must be unique among the environment's webhooks. The signing_secret is only returned in this response and cannot be retrieved again. Store it securely and use it to verify that webhook payloads were sent by Mux.

Request body params
address
string

The URL where Mux should send webhook notifications. Must be unique among the environment's webhooks.

post
201
https://api.mux.com/system/v1/webhooks
Request
(application/json)
{
  "address": "https://example.com/webhook"
}
Response
(application/json)
{
  "data": {
    "id": "abc12d",
    "address": "https://example.com/webhook",
    "enabled": true,
    "created_at": "2026-07-15T12:00:00.000000Z",
    "signing_secret": "9d0hnvbtpk3rfqe0m8s2a71cu5j6l4gd"
  }
}