# webhook.disabled

Canonical page: https://docs.ovok.com/signals/standalone/webhooks/webhook-disabled

Signals turned another subscriber's endpoint off because it answered `410` or kept failing. You are never told about your own.

## Payload [#payload]

Every delivery is the envelope `type`, `timestamp`, `sequence` and `data`; the delivery's id is the `webhook-id` header. See [Verify webhooks](/signals/standalone/verify-webhooks).

```json
{
  "type": "webhook.disabled",
  "timestamp": "2026-10-25T08:00:02.000Z",
  "sequence": 1059,
  "data": {
    "subscriber": "ovok-sub-4f2a9c",
    "reason": "failing",
    "disabledAt": "2026-10-30T08:00:00.000Z",
    "failingSince": "2026-10-25T08:00:00.000Z",
    "lastFailureAt": "2026-10-30T07:58:00.000Z"
  }
}
```

| Field | Meaning |
| --- | --- |
| `subscriber` | The subscriber whose endpoint was turned off. |
| `reason` | `gone` (it answered `410`) or `failing`. See [When deliveries fail](/signals/standalone/webhooks#when-deliveries-fail). |
| `disabledAt`, `failingSince`, `lastFailureAt` | When it was turned off, when the failures began, and the latest one. `failingSince` and `lastFailureAt` can be `null`. |

## Handle the event [#handle-the-event]

Verify the delivery first ([Verify webhooks](/signals/standalone/verify-webhooks)), then act on the verified event as in [Handle an event](/signals/standalone/webhooks#handle-an-event).

<Tabs items={["Node.js", "Python", "Java"]} groupId="language" persist>
<Tab value="Node.js">

```js title="webhook-disabled.js"
export async function handle(webhookId, event) {
  if (!(await firstTime(webhookId))) return;
  const { data } = event;
  switch (event.type) {
    case 'webhook.disabled':
      await alertEndpointOwner(data.subscriber, data.reason);
      break;
    default:
      break;
  }
}
```

</Tab>
<Tab value="Python">

```python title="webhook_disabled.py"
def handle(webhook_id: str, event: dict) -> None:
    if not first_time(webhook_id):
        return
    data = event["data"]
    match event["type"]:
        case "webhook.disabled":
            alert_endpoint_owner(data["subscriber"], data["reason"])
```

</Tab>
<Tab value="Java">

```java title="WebhookDisabledHandler.java"
void handle(String webhookId, JsonNode event) {
  if (!firstTime(webhookId)) return;
  JsonNode data = event.get("data");
  switch (event.get("type").asText()) {
    case "webhook.disabled" -> {
      alertEndpointOwner(data.get("subscriber").asText(), data.get("reason").asText());
    }
    default -> {}
  }
}
```

</Tab>
</Tabs>

## Related [#related]

- [Webhooks basics](/signals/standalone/webhooks)
- [Verify webhooks](/signals/standalone/verify-webhooks)
