Update webhook | ListBee

import requests
url = "https://api.listbee.so/v1/webhooks/webhook_id"
payload = {
    "name": "Order notifications",
    "url": "https://example.com/webhooks/listbee",
    "events": ["order.paid"],
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.json())

{
  "id": "wh_3mK8nP2qR5tW7xY1",
  "name": "Order notifications",
  "url": "https://example.com/webhooks/listbee",
  "secret": "whsec_a1b2c3d4e5f6",
  "events": [
    "order.paid"
  ],
  "enabled": true,
  "readiness": {
    "ready": true,
    "actions": [
      {
        "code": "connect_stripe",
        "kind": "api",
        "message": "Set Stripe secret key to accept payments",
        "resolve": {
          "method": "POST",
          "endpoint": "/v1/account/stripe-key",
          "url": "https://console.listbee.so/connect/stripe",
          "params": {
            "secret_key": "sk_live_..."
          }
        }
      }
    ]
  },
  "created_at": "2026-04-01T09:00:00Z",
  "object": "webhook"
}

Update a webhook endpoint. Only provided fields are changed.

Authentication

AuthorizationBearer

API key (lb_ prefix). Pass as: Authorization: Bearer lb_...

Path parameters

webhook_idstringRequired

Webhook endpoint ID.

Request

This endpoint expects an object.

namestring or nullOptional

Display name

urlstring or nullOptionalformat: "uri"1-2083 characters

HTTPS endpoint URL

eventslist of enums or nullOptional

Replaces the current event subscriptions. Empty list subscribes to all events

enabledboolean or nullOptional

Set to false to pause delivery without deleting the endpoint

Response

Successful Response

idstring

Unique identifier

namestring

Display name

urlstring

Endpoint URL

secretstring

HMAC-SHA256 signing secret. Use to verify webhook payload signatures. See docs for verification examples.

eventslist of enums

Subscribed event types. Empty means all events

enabledboolean

false when delivery is paused

readinessobject

Readiness status with actionable steps if the webhook needs attention.

created_atdatetime

Time at which the endpoint was created

object"webhook"

Object type identifier. Always webhook.

disabled_reasonstring or null

Reason the webhook was disabled. consecutive_failures when auto-disabled after repeated delivery failures.

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error