v4

latestOpenAPI 3.1.0MIT2026-08-02128224900.7 KB

Webhooks

Update Webhook

Update a webhook's properties

patch/webhooks/{id}

idstring required

status'enabled' | 'disabled'

The status of a webhook.

event_typesExternalEventType[] required

The types of event for which the webhook will be triggered.

urlstring uri required

The URL to which the webhook will send POST requests.

descriptionstring

An optional description of the webhook, for reference.

signing_keystring

Optional HMAC signing key for webhook verification. When set, webhook requests will include an X-Buttondown-Signature header with sha256=<signature>.

{
  "event_types": [
    [
      "email.created",
      "email.sent"
    ]
  ]
}

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

status'enabled' | 'disabled' required